Datalore
 
2023.4
Shortcuts: Windows
Get a demo
  1. Notebook editor
  2. Cells
  3. SQL cells

SQL cells

Last modified: 28 August 2023

Use SQL cells to query the following data sources:

  • Attached databases

  • Dataframes

  • Attached .csv files

tip

SQL cells are the recommended method of work with SQL when activating reactive mode.

Query a database in an SQL cell

  1. Add an SQL cell:

    • Go to Tools | Attached data and click Connect SQL cell for the attached database that you want to query.

      Opening an SQL cell from Attached data

    • Hover over the bottom border of a cell and select More cell types | SQL. If there are several attached databases, in the cell, click Select database and select the required data source.

      Selecting a database for querying

  2. Enter an SQL statement.

    note

    The cell provides code completion based on the introspected database schema.

  3. Run the query (Run icon or Ctrl,0+,Enter shortcut). The result set will be shown in the output and saved to a DataFrame. The resulting DataFrame name is shown in the cell toolbar.

    tip

    By clicking the Stop button or interrupting/restarting the kernel, you explicitly stop querying the database.

  4. (Optional) To rename the data object, click the object name next to RESULT SAVED TO on the SQL toolbar.

tip

To get a visual representation of the retrieved data, switch to the Visualize tab. Find more details in Automatic plotting.

Query a DataFrame or .csv file in an SQL cell

  1. Hover over the bottom border of a cell and select More cell types | SQL.

  2. In the added SQL cell, click Select database and select Dataframes.

  3. Enter an SQL statement.

    note

    If you query a .csv file, provide only the file name if it's a notebook attached file or a full path if it's a workspace file.

  4. Run the query. The result set will be shown in the output and saved to a DataFrame. The resulting DataFrame name is shown in the cell toolbar.

Query a DataFrame or .csv file in an SQL cell

  1. Hover over the bottom border of a cell and select More cell types | SQL.

  2. In the added SQL cell, click Select database and select Dataframes.

  3. Enter an SQL statement. Run the query. The result set will be shown in the output and saved to a DataFrame. The resulting DataFrame name is shown in the cell toolbar.

    tip

    By clicking the Stop button or interrupting/restarting the kernel, you explicitly stop querying the database.

  4. (Optional) To rename the data object, click the object name next to RESULT SAVED TO on the SQL toolbar.

tip

To get a visual representation of the retrieved data, switch to the Visualize tab. Find more details in Automatic plotting.

SQL cell examples

Querying a Snowflake database

Querying a Snowflake database

Querying a DataFrame

Querying a DataFrame

Querying a .csv file

Querying a csv file

Parameterized SQL queries

You can use Python variables in your SQL queries in Datalore. Such queries can be reused repeatedly with different values, which helps make your reports more interactive.

Supported variable types are: strings, numbers, booleans, and lists. Make sure you place your variable inside {} brackets.

Parameterized SQL query example

In the image below, you can see two cells:

  • Dropdown interactive control cell using the method variable.

  • SQL cell where the value in payment column equals the method variable value selected from the dropdown list.

Using a parameterized SQL query