Knowledge base

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 grant Xplenty access only to projects and associated datasets that you specifically select.

Project Access

To run Load jobs, grant READ permissions to Xplenty for the relevant BigQuery dataset project container:

  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 -> IAM
  4. Click +Add.
  5. Paste Xplenty's Google Cloud email under New Members
    On Select a role, add Project -> Viewer

  6. Click Save.

    Dataset Access

    To enable Xplenty to write to a specific dataset, grant WRITE permissions to Xplenty for the relevant BigQuery Dataset:

    1. Access your BigQuery console.
    2. In the BigQuery sidebar, under Resources, select your project, then select your dataset
    3. Paste Xplenty's Google Cloud email under Add members
      On Select a role, add BigQuery Data Editor
    4. Click Add.

    Source Component Access mode permission

    BigQuery source component has two access modes, Table and Query

    For Table access mode, Xplenty connects directly to the dataset and BigQuery Data Viewer role would suffice.
    For Query access mode, Xplenty creates a staging table based on the query and BigQuery Data Editor role is needed.

    For more information, see Google BigQuery Access Control.

    External tables access

    In order to read data from external tables that are based on Google Sheets, share the sheets (or a directory containing them) with the service account