Creating a Google Sheets connection
Warning
Before creating a connection, check out these limitations.
To create a Google Sheets connection:
-
Open the connection creation page
. -
Under Files and services, select the Google Sheets connection.
-
Add files depending on access permissions:
Public spreadsheetSpreadsheet with restricted access- Click + Add file and specify the link to the file. To do this, in the Google Sheets access settings, select
Anyone with the linkand copy the link to the sheet you need from your browser's address bar. If you copy the link from the Google Sheets sharing window, it will lead to the first sheet of the spreadsheet. - Click Add. If your file contains multiple sheets, specify the ones you want to upload in the Add sheets window. You cannot select empty sheets. Enable the Sheets option to select all available sheets. Each sheet is uploaded to a separate table. Click Add.
- Information about this file and the data to upload will appear at the center of the screen.
- At the top of the screen, click Log in with Google.
- Select the account to go to the DataLens application.
- Allow DataLens to access your Google account. Click Continue.
- Click + Add file and specify the link to the file.
- Click Add. If your file contains multiple sheets, specify the ones you want to upload in the Add sheets window. You cannot select empty sheets. Enable the Sheets option to select all available sheets. Each sheet is uploaded to a separate table. Click Add.
- Information about this file and the data to upload will appear at the center of the screen.
To sign out of your Google account, click
. Click Sign out. The sheets from the files with restricted access will no longer be displayed.Note
- To properly identify the data types, select Format → Numbers in the Google Sheets menu and set the column cell format.
- If a filter is enabled in your Google Sheets table, only data matching the filter criteria will be displayed in connections and datasets based on it.
- Click + Add file and specify the link to the file. To do this, in the Google Sheets access settings, select
-
Set the Show column headers option to Yes or No.
-
Optionally, enable automatic updates for spreadsheet data. To do this, in the top-right corner, select Update automatically. Spreadsheet data will be updated every 30 minutes or less often. To update your data manually, click Update data.
-
Click Create connection.
-
Select the workbook to save your connection to or create a new one. If using legacy folder navigation, select a folder to save the connection to. Click Create.
-
Enter a name for the connection and click Create.
You can add, rename, and delete files in the connection.
Additional settings
You can limit data export from charts based on this connection. To do this, click
Limitations
When creating a connection to Google Sheets, consider the following limitations:
-
The maximum number of Google Sheets per connection is 10. When creating a connection, all sheets will be loaded, but you can only select ten of them to work with at the same time.
-
Maximum size per sheet: 200 MB.
Note
Technically, you cannot check the size of an individual sheet in the connection. If the limit is exceeded, you will get a message saying the data could not be loaded.
-
Maximum number of columns per sheet: 300.
-
Minimum number of rows per spreadsheet: 2. In a spreadsheet with one row, you cannot identify column types as you cannot tell a header from a data row.
FAQ
See how to replace a legacy Google Sheets connection with a new one.
What do I do if a Google Sheets spreadsheet works incorrectly?
If a Google Sheets spreadsheet contains empty cells, DataLens may incorrectly display column headers and miss the first several rows.
To fix this, you need to fill empty cells in your Google Sheets spreadsheet with any appropriate values, e.g., unavailable, none, unknown.
To quickly populate empty cells in a Google Sheets spreadsheet:
- Select the entire Google Sheets spreadsheet.
- In the spreadsheet menu, select Data → Create filter.
- In the right-hand corner of the first column's top cell, click the filter icon.
- Select Clear and then select (Blanks).
- In the column's top cell, enter the appropriate value, e.g.,
0,unavailable,none, or any other. - Drag the cell down to populate all the empty cells in the column with this value.
- Click the filter icon again and click Select all.
- Repeat all the steps starting with Step 3 for the other columns in the spreadsheet.
What to do if you get the "Document not supported" error?
This error occurs when trying to create a connection to an XLSX table from Google Sheets.
To fix it, save the table in Google Sheets format: in the table menu, select File → Save as Google table.