Snowflake Connector for Google Analytics Raw Data のデータインジェスチョンの設定¶

Snowsightを使用したデータインジェスチョンの変更¶

インジェストされるGoogleアナリティクステーブル、またはテーブルの同期スケジュールを変更するには、次を実行します。

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

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

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

4. Snowflake Connector for Google Analytics Raw Data のページで Data Sync セクションに移動します。

5. Edit properties を選択します。

6. インジェストするテーブルを変更します。

   1. インジェストするテーブルを検索します。

   2. 選択または選択解除するテーブルの横にある Status 列のチェックボックスを選択します。

7. Update data sync を選択します。

インジェスチョンに使用できるプロパティのリスト¶

指定された GCP プロジェクト内で利用可能なすべてのプロパティをリストするには、以下のストアドプロシージャを呼び出します:

CALL LIST_GA_PROPERTIES();

Copy

その結果、認証されたアカウントによってインジェストされる利用可能なすべてのプロジェクトとプロパティが表示されます。結果が返ってこない場合は、次を確認してください:

• Googleアナリティクスから BigQuery へのデータエクスポートが設定されているかどうか。

• エクスポートされたデータが BigQuery で表示されているかどうか。

• 使用するサービスアカウント/認証ユーザーに適切なロールが割り当てられているかどうか。

データエクスポートの設定から BigQuery にデータを保存するまでに最大24時間かかることをご了承ください。この遅延は、 LIST_GA_PROPERTIES プロシージャが結果を出さない原因となる可能性があります。

Googleアナリティクスのエクスポートをオフにしても、 LIST_GA_PROPERTIES によってプロパティが省略されるわけではありません。エクスポートがオフになっても、データは BigQuery に保持され、コネクタによって同期されます。

宛先データベースの準備¶

インジェスチョンを有効にする前に、宛先データベースとスキーマ内のテーブルとビューを作成するアクセス権をコネクタに付与する必要があります。

GRANT USAGE ON DATABASE <destination database> TO APPLICATION <application name>;

GRANT USAGE ON SCHEMA <destination database>.<destination schema> TO APPLICATION <application name>;

GRANT CREATE TABLE ON SCHEMA <destination database>.<destination schema> TO APPLICATION <application name>;

GRANT CREATE VIEW ON SCHEMA <destination database>.<destination schema> TO APPLICATION <application name>;

Copy

プロパティのインジェスチョンの有効化また無効化¶

Googleアナリティクス内にある特定のテーブルのデータの同期を有効または無効にするには、次の引数で ENABLE_PROPERTIES ストアドプロシージャを呼び出します。

CALL ENABLE_PROPERTIES('<gcp_project>', ['<properties_to_configure>'], <enable_initial_load>, <exclude_nulls>, <disable_auto_reloads>, <enabled_export_types>);

Copy

条件:

gcp_project

有効なプロパティの GCP プロジェクトを指定します。

properties_to_configure

Googleアナリティクスのプロパティ名を一重引用符でコンマ区切りにしたリストを指定します。

接頭辞 analytics_ を除いたプロパティ名を使用します。

enable_initial_load

現在の同期と並行してプロパティのすべての履歴データをロード中である、初期データ読み込みを有効にするか無効にするかを示すブール。

これはオプションの引数で、デフォルト値は true です。

プロパティが以前に有効だった場合、このフラグは無視され、インジェスチョンは、プロパティが無効化されたときに停止した時点から継続されます。

exclude_nulls

インジェストれたデータからNULL値を含むフィールドを除外するかどうかを示すオプションのブール値。このパラメーターを true に設定すると、データインジェスチョンのスループットが向上します。デフォルト値は false です。

disable_auto_reloads

自動再ロードを無効にするかどうかを示すオプションのブール値。自動再ロードの詳細については、 Snowflake Connector for Google Analytics Raw Data のデータインジェスチョンモデル をご参照ください。この値を true に設定すると、クレジットの消費を抑えることができますが、遅れたデータはSnowflakeにインジェストされません。true エクスポート・タイプでは、このプロパティを FRESH_DAILY にセットすることはできません。デフォルト値は false です。

enabled_export_types

コネクタがデータのインジェストを試みるエクスポートタイプのオプションリスト。可能な値は DAILY、 FRESH_DAILY、 INTRADAY、 USERS と PSEUDONYMOUS_USERS です。デフォルトでは、 FRESH_DAILY を除くすべてのエクスポート・タイプが有効になります。

た と えば、プロジェクト property1 内の property2、 property3、 gcp_example_project というプロパティ の同期を有効にす る には、 以下のクエリを実行します。

CALL ENABLE_PROPERTIES('gcp_example_project', ['property1','property2','property3']);

Copy

初期データのロードなしでプロパティを有効にするには、次に類似する ENABLE_PROPERTIES クエリを使用します。

CALL ENABLE_PROPERTIES('gcp_example_project', ['property1','property2','property3'], false);

Copy

BigQuery に日次データとユーザーデータしかない場合は、以下のクエリを実行することで、日中のエクスポートを明示的に省略することができます。

CALL ENABLE_PROPERTIES(PROJECT_ID => 'gcp_example_project', PROPERTY_IDS => ['property1'], ENABLED_EXPORT_TYPES => ['DAILY', 'FRESH_DAILY', 'USERS', 'PSEUDONYMOUS_USERS']);

Copy

名前付き引数を使用すると、特定の引数を指定し、残りは変更せずに残すことができます。たとえば、初期ロードでプロパティを有効にし、NULL値を含むフィールドを除外するには、次のクエリを実行します。

 CALL ENABLE_PROPERTIES(
    PROJECT_ID => 'gcp_example_project',
    PROPERTY_IDS => ['property1', 'property2', 'property3'],
    INITIAL_LOAD => TRUE,
    EXCLUDE_NULLS => TRUE
);

Copy

これらのプロパティが取り込まれないようにするには、以下のコマンドを実行する：

CALL DISABLE_PROPERTIES('gcp_example_project', ['property1','property2','property3']);

Copy

プロパティを無効にすると、同期が停止します。プロパティの同期を無効にすると、開始したけれどもまだ終了していないインジェスチョン全体が宛先データベースから削除されます。

ENABLE_PROPERTIES プロシージャは、指定されたプロパティ名を ENABLED_PROPERTIES ビューに追加します。