Google BigQuery に接続する

To connect BigQuery to the Analyticsapp, you’ll need to:

1. Set up a service account in Google Cloud Platform.

2. Upload the generated JSON key to the Analytics app.

サービス アカウントを作成する

サービス アカウントには、次のいずれかの権限を設定できます。

• プロジェクト レベルの権限

• データセット レベルの権限

プロジェクト レベルの権限を設定する

サービス アカウントにプロジェクト レベルの権限を設定するには:

1. Log in to Google Cloud Platform and navigate to the project you want to use in the Analytics app.

2. サイドバーで、[IAM & admin (IAM & 管理)] > [Service accounts (サービス アカウント)] の順に選択します。

3. [Create service account (サービス アカウントを作成)] を選択します。

4. サービス アカウントの名前を入力します。後でアカウントの目的を思い出せるように、「Atlassian Analytics」という名前を付けることをおすすめします。

5. サービス アカウントに、「BigQuery Data Viewer」と「BigQuery User」という 2 つのロールを追加します。アナリティクスが BigQuery データに接続できるようにするには、両方のロールを選択する必要があります。

6. [Continue (続行)] を選択します。すると、[Service accounts (サービス アカウント)] ページに戻ります。

7. 新しく作成したサービス アカウントで、[Actions (アクション)] > [Manage keys (キーを管理)] の順に選択します。

8. [Add key (キーを追加)] > [Create new key (新しいキーを作成)] の順に選択します。

9. キー タイプとして [JSON] を選択してから [Create (作成)] を選択します。

Your JSON key will be generated and downloaded to your computer. Save the JSON file to a secure location. You can delete it after you upload the key to the Analytics app.

データセット レベルの権限を設定する

プロジェクト レベルの権限を付与するのではなく、データセット レベルの権限を付与することもできます。

これを行うには、次の手順に従う必要があります。

1. カスタム ロールを作成する

2. 作成したロールをサービス アカウントに割り当てる

3. そのロールがアクセスできるデータセットを制限する

カスタム ロールを作成する

1. Log in to Google Cloud Platform and navigate to the project you want to use in the Analytics app.

2. サイドバーで、[IAM & admin (IAM & 管理)] > [Roles (ロール)] の順に選択します。

3. 画面の上部で [Create role (ロールを作成)] を選択します。

4. [Title (タイトル)] フィールドに名前 (atlassian-analytics-role など) を入力し、必要に応じて説明を入力します。

5. [Add permissions (権限を追加)] を選択し、次の権限をロールに追加します。

• bigquery.jobs.create

• resource manager.projects.get

6. [Add (追加)] を選択して権限を保存します。

7. [Create (作成)] を選択してカスタム ロールを作成します。

作成したロールをサービス アカウントに割り当てる

作成したカスタム ロールは、次のいずれかに割り当てることができます。

• 新しいサービス アカウント

• 既存のサービス アカウント

新しいサービス アカウントにカスタム ロールを割り当てるには:

1. 前述の「プロジェクト レベルの権限を設定する」セクションで説明した手順 1～4 に従います。

2. ロールを選択するように求められたら、作成したカスタム ロールを選択します。

3. [Done (完了)] を選択します。

4. 「プロジェクト レベルの権限を設定する」セクションの残りの手順に従って、サービス アカウントの作成を完了します。

5. サービス アカウントのメール アドレスをコピーします。これは次のセクション (「データセットを制限する」) で必要になります。

既存のサービス アカウントにカスタム ロールを割り当てるには:

1. サイドバーで、[IAM & Admin (IAM & 管理)] > [IAM] の順に選択します。

2. 使用するサービス アカウントを見つけて、[Edit principal (プリンシパルを編集)] を選択します。

3. 作成したカスタム ロールを割り当てます。

4. [Save (保存)] を選択します。

データセットを制限する

1. BigQuery インスタンスに戻ります (プロジェクトが同じであることを確認します)。

2. データセットを選択し、[Sharing (共有)] を選択します。

3. [Sharing (共有)] ドロップダウン メニューから [Permissions (権限)] > [Add principal (プリンシパルを追加)] の順に選択して、新しいメンバーを追加します。

4. [New principals (新しいプリンシパル)] フィールドに、カスタム ロールを割り当てたサービス アカウントのメール アドレスを貼り付けます。

5. この新しいプリンシパルに「BigQuery data viewer」ロールを割り当てます。

BigQuery をアナリティクスに追加する

After creating a service account and generating your JSON key, you can complete the connection form in the Analytics app to add your Google BigQuery database.

To add Google BigQuery to the Analytics app:

1. サイドバーから [データ ソース] を選択します。

2. [データソースを追加] > [Google BigQuery] の順に選択します。

3. 生成した JSON キーをアップロードします。Google が JSON キーを受け入れるまでに数分かかる場合があります。

4. JSON キーが受け入れられたら、以下の手順を実行します。

   1. Provide a Display name for your data source. This name is only used in the Analytics app and can be changed later.

   2. プロジェクト ID の認証を行います。

   3. 課金される最大バイト数を指定します。これにより、課金対象とする固定サイズを超えるクエリが実行されないように制限をかけます。

5. [送信] を選択します。

アナリティクスがデータベースに接続されてスキーマが取得されると、データ ソースを使用する準備が整います。

Google BigQuery の SQL 構文

Google BigQuery uses its own proprietary SQL, so you need to use that syntax when you create SQL mode queries. Refer to Google BigQuery’s query syntax documentation for more help.