ETL+ for Google Sheets

Owned by Cortlandt _
Jun 24, 2023
3 min read

How to connect your Google Sheets to ETL+ for data extraction.

Installation Checklist

ETL+ Mapping to your Google Sheets

  • Grant ETL+ with rights to extract your Google Sheets:

  • Contact support @dataself.com and ask for the ds-etlplus-api-6fe985c1a9a8.json file.

    • Save that received JSON file inside a new folder named ..\<ETL+ directory>\Credentials.

  • Login to ETL+ (help here).

  • Adding a new Google Sheet source: On ETL page’s left panel, click Add Source -> Google Sheet.

  • Maintaining a Google Sheet source: On ETL page’s left panel, right-click the Google Sheet source → Properties.

  • On the Google Sheet page:

    • Give it an Alias.

    • From your Google Sheets, copy the string below into the Spreadsheet ID field.

    • Leave Target (optional) empty to show all spreadsheet tabs, or add the name of one of them.

    • Click Connect.

  • You’ll get back to the ETL page and see tables under the new Google Sheets source on the left panel.

  • Mapping Tips:

    • To reference a group of cells, use the name of the sheet followed by an exclamation mark, the column of the top left cell, its row, a colon, the row of the bottom right cell, and its column. Example: Sheet3!B3:D10.

    • All rows in one column: Sheet3!B:B (use the column name twice and omit the row numbers).

    • All rows in multiple adjacent columns: Sheet3!B:D (use the names of the first and last column in the range and omit the row numbers).

    • All columns in multiple adjacent rows: Sheet3!2:10 (use the numbers of the first and last row in the range and omit the column names).

Mapping and Loading Tables

  • To view tables available from your Google Sheets source on the left panel, right-click the Google Sheets source → Refresh.

  • To map an Google Sheets table to the data warehouse, double-click its name on the left panel, or right-click on it → Add Table.

    • You’ll now see the table added/mapped to the center panel.

  • To preview its data, right-click the table on the center panel → Preview.

  • To load its data to the data warehouse, right-click the table on the center panel → Load Now.

  • Click the Log icon (top right) to view data load results. Log page help here.

Schedule the Data Load

  • On the ETL main page, click Refresh Batch (top right icon on the center panel).

  • Select a Refresh Batch or create a new one to load your Google Sheets source data on a schedule (help here) → on the right panel, be sure the Google Sheets source tables to load have their boxes checked and in the desired load order.

  • To load them now, click the Refresh Batch Now (play icon) on the left panel for the desired Refresh Batch.

  • To schedule the data load:

    • Click WTS Settings -> enter the WTS parameters → Apply.

    • This step might require you to run ETL+ app as “Run as administrator” in Windows.

  • Click Close -> Close.

Testing

After ETL+ has loaded your Google Sheets source tables, this is to check if the data extraction process finished successfully and row count per extracted table matches with your Google Sheets source tables.

Steps

  • Login to ETL+ (help here).

  • On the ETL main page, click the top-right Log icon. Log page help here.

  • Scroll down on the log page and double-check that no table load failed, and that the row count matches with the source Google Sheets tables. Following is an example highlighting two tables from a sample Google Sheets database and their loaded row count.