Snowflake Connector for Google Analytics Raw Data のインストールと構成

このトピックでは、 Snowflake Connector for Google Analytics Raw Data を介して Snowsight をインストールおよび構成する方法について説明します。

Snowflake Connector for Google Analytics Raw Data のインストール

コネクタをインストールするには、次を実行します。

  1. Snowsight ロールを持つユーザーとして ACCOUNTADMIN にサインインします。

  2. ナビゲーションメニューで Marketplace を選択します。

  3. Snowflake Connector for Google Analytics Raw Data を検索し、コネクタのタイルを選択します。

  4. Snowflake Connector for Google Analytics Raw Data のページで、 Get を選択します。

    これにより、インストールプロセスの最初の部分を開始するために使用するダイアログボックスが表示されます。

    ダイアログボックスで、次のように構成します。

    1. Options->Application name フィールドで、コネクタインスタンスのデータベースとして使用するデータベースを入力します。このデータベースは自動的に作成されます。

    2. Warehouse used for installation フィールドで、コネクタのインストールに使用するウェアハウスを選択します。

      注釈

      これは、コネクタがGoogleアナリティクスからのデータを同期するために使用するウェアハウスとは異なります。後のステップで、この目的のために別のウェアハウスを作成します。

    3. Get を選択します。

  5. Open を選択します。

    ダイアログボックスが閉じ、 Snowflake Connector for Google Analytics Raw Data ページに、コネクタを構成および管理するための UI が表示されます。

Snowflake Connector for Google Analytics Raw Data の構成

注釈

Snowflake Connector for Google Analytics Raw Data は SQL を使用して設定することもできます。 SQL を使用した構成は上級者向けのトピックです。詳細については、 Snowflake Connector for Google Analytics Raw Data を使用した SQL の構成 をご参照ください。

コネクタを構成するには、次を実行します。

  1. ACCOUNTADMIN ロールまたは次の要件を満たす他のロールを持つユーザーとして、Snowsight にサインインします。

    • これらのアカウントレベルの権限が必要です。

      • EXECUTE TASK（付与オプション付き）

      • EXECUTE MANAGED TASK（付与オプション付き）

    • アカウントで EVENT_TABLE を有効にする必要があります。

    • ウェアハウスへのアクセスには、次の権限の少なくとも1つを持っている必要があります。

      • アカウントの CREATE WAREHOUSE 権限。

      • ウェアハウスの OWNERSHIP 権限

      • ウェアハウスの USAGE 権限（付与オプション付き）

    • データベースにアクセスするには、次の権限の少なくとも1つを持っている必要があります。

      • アカウントの CREATE DATABASE 権限。

      • データベースの OWNERSHIP 権限

      • データベースの USAGE 権限（付与オプション付き）

    • スキーマへのアクセスの場合は、以下の権限の少なくとも1つを持っている必要があります。

      • アカウントの CREATE DATABASE 権限。

      • データベースの OWNERSHIP 権限

      • データベースの USAGE 権限（付与オプション付き）

      • データベースの CREATE SCHEMA 権限

      • スキーマの USAGE、CREATE TABLE、CREATE VIEW 権限（付与オプション付き）

    • オプション：ロールアクセスについては、新しいロールを作成するか、DATA_READER アプリケーションロールが割り当てられる既存のロールを選択できます。新しいロールを作成する場合は、アカウントに対する CREATEROLE 権限が必要です。ただし、これは構成を完了するために必要ではありません。

  2. ナビゲーションメニューで Catalog » Apps を選択します。

  3. Snowflake Connector for Google Analytics Raw Data を選択します。

    構成ウィザードが起動します。

  4. 前提条件

    1. リストの前提条件がすべて満たされていることを確認し、完了マークを付けます。

    2. Start configuration をクリックします

  5. ウェアハウス、データベース、スキーマ、ロールの構成

    注釈

    デフォルトでは、フィールドはコネクタの構成時に作成されるオブジェクトの名前に設定されます。Snowflakeは、これらのフィールドに新しいオブジェクトを使用することをお勧めします。ただし、必要に応じて既存のオブジェクトの名前を指定できます（例: コネクタを再インストールする場合）。

    以下のフィールドに入力し、画面下部の Configure を選択します。

    フィールド

    説明

    Warehouse

    コネクタ専用の新しい仮想ウェアハウスの識別子を入力するか、既存の識別子を選択します。

    アカウントに一意の名前を指定します。ウェアハウスの名前は、有効な オブジェクト識別子 である必要があります。

    注釈

    コネクタのインストールの開始時に選択したものと同じウェアハウスを指定しないでください。

    構成プロセスにより、指定された名前で新しい X-Small ウェアハウスが作成されます。

    または、既存のウェアハウスを選択することもできます。

    Destination Database

    Snowflake内にあるGoogleアナリティクスデータのテーブルがあるスキーマを含む新しいデータベースの識別子。Googleアナリティクスからダウンロードされたデータはここに表示されます。

    アカウントに一意の名前を指定します。データベースの名前は、有効な オブジェクト識別子 である必要があります。

    構成プロセスにより、指定された名前で新しいデータベースが作成されます。

    または、既存のデータベースを選択することもできます。

    Destination Schema

    Snowflake内にあるGoogleアナリティクスデータを含む新しいスキーマの識別子。

    Snowflake Connector for Google Analytics Raw Data はGoogleアナリティクスデータをこのスキーマのテーブルにインジェストします。

    スキーマの名前は、有効な オブジェクト識別子 である必要があります。

    構成プロセスにより、指定された名前で新しいスキーマが作成されます。

    あるいは、既存のスキーマを選択することもできます。

    Role

    コネクタ用の新しいカスタムロールの識別子。

    アカウントに一意の名前を指定します。ロールの名前は、有効な オブジェクト識別子 である必要があります。

    ロールは、インジェストされたデータへの読み取りアクセス権を持つアカウントレベルのロールです。

    または、既存のロールを選択することもできます。

    既存の宛先データベースとスキーマがプロバイダーから提供された場合、既存の正規テーブルとビューの所有権は Snowflake Connector for Google Analytics Raw Data に移行されます。たとえば、外部テーブルやマテリアライズドビューは除外されます。さらに、管理されたスキーマでは 何も 転送されません。

    構成プロセスが完了するまでにしばらくかかる場合があります。構成プロセスが正常に終了すると、構成ウィザードは Authentication に進みます。

  6. 認証の構成

    Snowflake Connector for Google Analytics Raw Data は**OAuth**と**サービスアカウント**の2つの認証方法をサポートしています。各メソッドには、 GCP プロジェクトでの追加設定が必要です。

    各認証の構成方法の詳細については、次をご参照ください。

    認証方法として**サービスアカウント**を使用する場合は、サービスアカウント認証情報を JSON ファイルに記述します。

    または、以下のフィールドに入力することもできます。

    フィールド

    説明

    Client email

    Google Cloud Platformプロジェクトのサービスアカウント作成プロセスで生成されたGoogleサービスアカウントのメール。

    Private key

    Google Cloud Platformプロジェクトのサービスアカウント作成プロセスで生成されたプライベートキー。

    -----BEGIN PRIVATE KEY-----、 -----END PRIVATE KEY-----、 \\n を削除したことを確認してください。

    認証方法**Oauth2**を使用する場合は、以下のフィールドに入力します。

    フィールド

    説明

    Client id

    Google Cloud Platformプロジェクトで生成されたクライアント ID。

    Client secret

    Google Cloud Platformプロジェクトで生成されたクライアントシークレット ID。

    ACCOUNTADMIN ロールでユーザーとしてサインインしていない場合、次の要件を満たしていることを確認してください。

    • CREATEINTEGRATION 権限を有している必要があります。

    • 統合が以前に他のロールによって作成された場合、それらの統合の所有権をあなたのロールに譲渡する必要があります。

    • CONNECTORS_SECRET データベースが存在しない場合、CREATEDATABASE 権限が必要です。

    • CONNECTORS_SECRET データベースが存在するものの別のロールによって作成された場合、これらの権限が必要です。

      • USAGE WITH GRANT OPTION

      • CREATE SCHEMA WITH GRANT OPTION

    • CONNECTORS_SECRET.APP_NAME スキーマは存在しますが、別のロールによって作成された場合、これらの権限が必要です。

      • USAGE WITH GRANT OPTION

      • CREATE SECRET

      • CREATE NETWORK RULE

    • の場合 CONNECTORS_SECRET.APP_NAME.SECRET は存在しますが、別のロールによって作成された場合、その所有権をあなたのロールに譲渡する必要があります。

    • の場合 CONNECTORS_SECRET.APP_NAME.NETWORK_RULE は存在しますが、別のロールによって作成された場合、その所有権をあなたのロールに譲渡する必要があります。

    Connect の選択

    **Oauth2**認証を選択した場合、Google OAuth2 認証のダイアログフローが表示されます。

    ダイアログでGoogleにログインし、Google OAuth2 認証フローを完了させます。

    認証プロセスが完了するまでには時間がかかる場合があります。

  7. ソースの検証

接続に成功したら、コネクタはGoogleアナリティクスのデータにアクセスできることを確認します。エラー時には、コネクタは追加の指示を出して説明します。

プロセスが正常に完了すれば、インジェストの構成を開始できます。詳細については、Snowflake Connector for Google Analytics Raw Data のデータインジェスチョンの設定 をご参照ください。

言語: 日本語