CData Excel Add-In for Google BigQuery 2019 - Online Help
Questions / Feedback?

CData Excel Formulas

CData Excel Add-In for Google BigQuery 2019 - Build 19.0.7354

The add-in provides formulas for executing read, create, update, and delete operations to Google BigQuery. The function parameters can refer to specific cells; as these values change, the add-in automatically refreshes the results. Since Excel formulas are stored within the Excel file, you can easily share your dynamic spreadsheets with others.

Example

The examples in this section are based on the range of data J14:L17, shown below. Note that for conciseness, these examples only show the cells with data, which makes it appear as if the data is top-left aligned, but a top-left alignment is not required: the rows of data can exist anywhere on the spreadsheet.

JKL
14 Id repository.name repository.name
15 MyId1 EntityFramework EntityFramework
16 MyId2 ... ...
17 MyId3 ... ...

CDATAQUERY

=CDATAQUERY(Query, [Connection], [Parameters], [ResultLocation], [Options])

This formula executes a SELECT, INSERT, UPDATE, or DELETE statement or a stored procedure call. By default, the cell where the formula is entered shows the number of rows returned or the number of rows that have been modified and subsequent rows show the results.

Query The Query argument is a string containing the query. For example:
SELECT * FROM publicdata.samples.github_nested
To execute a parameterized query, use the standard syntax:
SELECT actor.attributes.email, repository.name FROM publicdata.samples.github_nested WHERE repository.name = @repository.name AND repository.name = @repository.name

The add-in reads the parameters from a range. Specify the range in the Parameters property.

Connection A string that defines the connection: either a connection profile you created from the CData ribbon (see Managing Connections) or a connection string. Connection strings must include the Provider property. For example:
    Provider=Google BigQuery;ProjectId=NameOfProject;DatasetId=NameOfDataset;

The Connection argument is optional if you have used the Data Selection wizard to pull data into the spreadsheet. The formula uses this connection by default.

Parameters The Parameters argument specifies the range of cells that contains the names and values for the parameters. The first row of the range is a header row and specifies the parameter names.

For example, if the range A10:B11 contains the parameters then the cells A10:B10 should contain the parameter names, and the cells A11:B11 should contain the parameter values.

ResultLocation A string that specifies the cell where the row-by-row output of the results start. By default, CDATAQUERY outputs the results just below the cell where the formula was entered.
Options A string containing additional options to control the formula's behavior. The default behavior is to return data in a table, where the first row contains the column headers. "Headers=False" may be set to return the data without headers. "Scalar=True" may be set to return only a single cell of data, and return it into the same cell as the formula.

The following formula searches Google BigQuery and outputs the results starting at row J14.

=CDATAQUERY("SELECT actor.attributes.email, repository.name FROM publicdata.samples.github_nested WHERE repository.name = 'EntityFramework'","Google BigQueryConnection",,"J14")

The following formula selects only the repository.name for a single repository.name from Google BigQuery and outputs the result into the formula's cell.

=CDATAQUERY("Select repository.name FROM publicdata.samples.github_nested WHERE repository.name = " &J15,"Google BigQueryConnection",,,"Scalar=True")

CDATAINSERT

=CDATAINSERT(Data, [Table], [Connection], [ColumnHeaders])

Inserts the specified rows into the specified table.

Data The Data argument specifies the range of rows to insert, such as J15:L15. The first row must contain the column headers unless they are specified in the ColumnHeaders argument; if you set ColumnHeaders, set only the column values in the Data argument.
Connection A string that defines the connection: either a connection profile you created from the CData ribbon (see Managing Connections) or a connection string. Connection strings must include the Provider property. For example: Provider=Google BigQuery;ProjectId=NameOfProject;DatasetId=NameOfDataset;).

The Connection argument is optional if you have used the Data Selection wizard to pull data into the spreadsheet. The formula uses this connection by default.

Table The Table argument is a string that specifies the table to insert data into. This argument is optional if you have used the Data Selection wizard to pull data into the spreadsheet. The formula uses this table by default.
ColumnHeaders The ColumnHeaders argument specifies the range of cells that contains the column headers. The ColumnHeaders argument only needs to be specified if the column headers are not in the first row of data. You can also use the ColumnHeaders argument to specify the orientation of the data table: If the column headers are located in a vertical array, such as B20:B30, then each column is inserted as a row into the chosen table.

The following formula inserts 3 rows into the publicdata.samples.github_nested table. This insert assigns a new Id to each row. To refresh the Id values use the CDATAQUERY formula.

=CDATAINSERT(J14:L17,"publicdata.samples.github_nested","Google BigQueryConnection")

CDATAUPDATE

=CDATAUPDATE(Data, [Table], [Connection], [ColumnHeaders])

Updates the specified rows.

Data The range of rows to update, such as J15:L15. The first row must contain the column headers unless they are specified in the ColumnHeaders argument; if you set ColumnHeaders, set only the column values in the Data argument.
Connection A string that defines the connection: either a connection profile you created from the CData ribbon (see Managing Connections) or a connection string. Connection strings must include the Provider property. For example: Provider=Google BigQuery;ProjectId=NameOfProject;DatasetId=NameOfDataset;.

The Connection argument is optional if you have used the Data Selection wizard to pull data into the spreadsheet. The formula uses this connection by default.

Table The Table argument is a string that specifies the table to update. This argument is optional if you have used the Data Selection wizard to pull data into the spreadsheet. The formula uses this table by default.
ColumnHeaders The ColumnHeaders argument specifies a range of cells that contains the column headers. The ColumnHeaders argument only needs to be defined if the column headers are not in the first row of the specified data. You can also use the ColumnHeaders argument to specify the orientation of the data table: If the column headers are located in a vertical array, such as B20:B30, then each column is updated as a row into the chosen table.

The following formula updates the record in row 15 of the sheet:

=CDATAUPDATE(J14:L15,"publicdata.samples.github_nested","Google BigQueryConnection",J14:L15)

CDATADELETE

=CDATADELETE(Data, [Table], [Connection], [ColumnHeaders])

Deletes the specified rows.

Data The Data argument specifies the range of rows to delete, such as J15:L15. The first row must contain the column headers unless they are specified in the ColumnHeaders argument; if ColumnHeaders is specified, the range specifies only the values to be inserted.
Connection A string that defines the connection: either a connection profile you created from the CData ribbon (see Managing Connections) or a connection string. Connection strings must include the Provider property. For example: Provider=Google BigQuery;ProjectId=NameOfProject;DatasetId=NameOfDataset;.

The Connection argument is optional if you have used the Data Selection wizard to pull data into the spreadsheet. The formula uses this connection by default.

Table The Table argument is a string that specifies the table to delete the records from. This argument is optional if you have used the Data Selection wizard to pull data into the spreadsheet. The formula uses this table by default.
ColumnHeaders The ColumnHeaders argument specifies the range of cells that contains the column headers. The ColumnHeaders argument only needs to be specified if the column headers are not in the first row of the specified data. You can also use the ColumnHeaders argument to specify the orientation of the data table: If the column headers are located in a vertical array, such as B20:B30, then each column is updated as a row into the chosen table.

The following formula specifies the primary keys of the rows to delete:

=CDATADELETE(J14:L15,"publicdata.samples.github_nested","Google BigQueryConnection")

 
 
Copyright (c) 2020 CData Software, Inc. - All rights reserved.
Build 19.0.7354.0