Connect with Google's Cloud platform to have your IoT device and alert event data sent to a BigQuery table.

 

Connecting to Google BigQuery

Use the following steps to setup the Google BigQuery Integration.

Create your BigQuery dataset

  1. Log into your Cloud BigQuery account and select the project that you will be using.
    np_lightbulb_1247022_000000.png If needed, setup BigQuery for your project and make sure you have a dataset by clicking on the CREATE DATASET button.

    You do not need to create the table - the Integration will do this later when setting that up. For now, just locate the Dataset ID as you will need this later.
    mceclip0.png

Setup your Cloud Storage Account Service key

In this step we will setup an account key which will then be used by the Integration so that it can access your dataset to create the table and access data.

  1. In the Google Cloud console and go to IAM & admin and select the Service accounts option.
    mceclip3.png
  2. Click on Create Service Account.
    mceclip4.png
  3. Give the account an appropriate Name and description. The Service account ID will be generated automatically for you during this step - you can leave it as the default.
    mceclip5.png

    Click Create to create the service account and continue.
  4. On the Permissions screen that appears, give the account the permission BigQuery Data Owner so that it can access & create objects.
    mceclip6.png

    Click Continue and then Done to complete creating the service account.
  5. Locate the Service account you created, click on the 3-dot menu and select Create Key.
    mceclip7.png
  6. In the popup that appears, you can leave it as JSON and click Create. This will download a json file containing the private key information that we need when setting up the integration.
    mceclip8.png
  7. Open the downloaded json file. You will need to copy the entire contents from this file when asked during integration setup.
    mceclip9.png

 

Create the Integration

  1. Log into your account on the IoT in a Box portal.
  2. Select the Integrations option and then select the Google BigQuery integration.
  3. Enter the following information to complete the integration:
    • Name: Enter a name for this integration. In case you have multiple integrations, this will help uniquely identify it in the list.
    • Dataset ID: Paste the Table ID string used to locate your table in BigQuery.
    • Table ID: Enter in an appropriate table ID to be used to store your data in this Dataset.

      np_lightbulb_1247022_000000.png  You do not need to create this table. The Integration will automatically create the appropriate table structure once the integration setup is complete.
    • Service Account Key: Paste the entire contents of the service key file, as obtained above.
      np_lightbulb_1247022_000000.png Paste the entire contents of the json private key file here.
      mceclip1.png

np_right_610363_000000.png After saving the Integration, you will see it shown in your list of integrations.

BQ2.PNG

  • You can then edit the integration to make any changes needed.
  • You can also toggle the Integration on/off at any time from here as well. Disabling the integration will stop new data from being sent to the BigQuery table.

Verifying things are working

You can verify the integration is working by logging into the Google Cloud Console and viewing the records of your table.

np_lightbulb_1247022_000000.png Note: You can view the records as columnar table data or switch to view them in JSON format.

BQ4.PNG