Allowing Xplenty access to my Google BigQuery dataset

Xplenty uses highly secured certificate-based authentication for connecting to your Google BigQuery Dataset. You need to provide your own service-account's JSON-key and grant Xplenty access only to projects and associated datasets that you specifically select. This article discusses providing Xplenty access on your Google BigQuery dataset and then details creating the BigQuery connection in Xplenty.

Project Access

  1. Access your Google Cloud Console.
  2. Click the project name for which you want to grant Xplenty access.
  3. On the sidebar, choose IAM & Admin -> Service Accounts
  4. Click "+ CREATE SERVICE ACCOUNT"
  5. Fill-out service account details and then grant following roles
    • BigQuery Data Viewer 
    • BigQuery Job User

undefined

Dataset Access

  1. Access your BigQuery console.
  2. In the BigQuery sidebar, under Resources, select your project, then select your dataset, click SHARE DATASET and select Permissions
  3. Click "+ ADD PRINCIPAL" and then assign following roles:
    • BigQuery Data Editor
    • BigQuery Data Viewer

undefined

Create a service-account JSON-key

  1. Access your Google Cloud Console.
  2. Click the project name for which you want to grant Xplenty access.
  3. On the sidebar, choose IAM & Admin -> Service Accounts
  4. Select & click the service account that has been created in previous step, click "KEYS" tab on the top and then click "ADD KEY" -> "Create new key" -> choose "JSON" -> click "CREATE"
  5. A JSON-key file will be automatically downloaded to your machine.

undefined

Create Google BigQuery connection in Xplenty

  1. Click the Connections icon (lightning bolt) on the top left menu.
  2. To create a connection, click New connection.Screen+Shot+2020-03-16+at+3.44.54+PM.jpg
  3. Choose Google BigQuery.
  4. Name the connection.
  5. Fill in Dataset ID and select the region where your BigQuery is hosted
  6. Upload a JSON-key file that you have created on previous step. Service account email and Project ID will be filled in automaticallyundefined
  7. Click Test Connection to make sure the connection details are correct.
  8. Click Create connection to create the connection.

Migrate from previous version of Google BigQuery connector

Customers who have created previous version of BigQuery connector and want to migrate to the latest version of BigQuery connector, please follow these steps: 

  1. Select package containing BigQuery connector from your dashboard
  2. On the package designer page, select BigQuery source and/or destination components that you want to modify
  3. Replace previous version of BigQuery with connection that has prefix ID BIGQUERYV2_CONNECTION_undefined
  4. Remove Xplenty's service account email (869780223921-fkm5hu2ev8la67tqrntm6b5tjm6c6sgl@developer.gserviceaccount.com​) from your both project's and dataset's permission.

    1. To remove from your project's permissions, access your Google Cloud Console and go to IAM & Admin -> Service Accounts, select checkbox on Xplenty's service account email and click DELETE
    2. To remove from your dataset's permissions, access your BigQuery console. In the BigQuery sidebar, under Resources, select your project, then select your dataset, click SHARE DATASET and select Permissions. Remove Xplenty's service account email from each assigned role by clicking delete icon.