Snowflake Connector for Google Analytics Raw Data の管理

Snowflake connector for Google Analytics Raw Dataは、 コネクタ規約 に従うものとします。

このトピックでは、コネクタをインストールして構成した後に実行が必要になる可能性のある一般的なタスクについて説明します。

コネクタのインジェスト間隔の変更

コネクタは定期的にチェックし、 BigQuery からデータをダウンロードします。チェックはデフォルトでは8時間ごとに行われますが、変更することもできます。データの確認とダウンロードに新しい間隔を設定したい場合は、 PUBLIC スキーマで定義されている CONFIGURE_INGESTION_INTERVAL プロシージャを使用してください:

CALL CONFIGURE_INGESTION_INTERVAL(<interval_configuration_name>)
Copy

可能な間隔構成と内部で使用されるCRON定義:

EVERY_15_MINUTES   -   */15 * * * * UTC
EVERY_30_MINUTES   -   */30 * * * * UTC
EVERY_1_HOUR       -   0 * * * * UTC
EVERY_4_HOURS      -   0 3/4 * * * UTC
EVERY_8_HOURS      -   0 3/8 * * * UTC
EVERY_1_DAY        -   0 3 * * * UTC
Copy

注釈

カスタムCRON式を設定することはできません。

使用例:

CALL CONFIGURE_INGESTION_INTERVAL('EVERY_1_HOUR')
Copy

サポートされている間隔のリストは、 PUBLIC スキーマで定義されている LIST_SUPPORTED_INGESTION_INTERVALS プロシージャを使用して印刷することもできます。

CALL LIST_SUPPORTED_INGESTION_INTERVALS()
Copy

アラートの設定

アラートを設定するには、次を実行します。

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

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

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

  4. Snowflake Connector for Google Analytics Raw Data のページで Settings セクションに移動し、左のメニューから Email alerts を選択します。

    メールアラート構成のページが表示されます。

  5. Email Address フィールドに、Snowflakeで認証されたメールアドレスを入力します。

注釈

Snowflakeアカウントに関連付けられているメールアドレスを指定する必要があります。

  1. Email Frequency フィールドで、アラートの受信頻度を選択します。

  • Immediately - テーブル同期で設定された値に従って通知を受け取ります。

  • Once per day - 12PM UTC に1日1回通知を受け取ります。

注釈

アラートは、無効なアクション（エラーなど）が発生した場合にのみ送信されます。

  1. メールアラートの受信を開始するには、 Save changes を選択します。

アラートの無効化

アラートの受信を停止するには、メールアラート構成ページで Stop receiving alerts を選択します。

コネクタのアップグレード

コネクタのアップグレードは、アプリケーションのプロバイダーによって自動的に管理されます。

コネクタのスケーリング

十分なパフォーマンスが得られる可能性が高いため、 X-Small を使用してコネクタでの作業を開始する必要があります。ただし、コネクタの速度低下が発生する場合は、ウェアハウスサイズを徐々に増やし、各ステップでパフォーマンスが向上するかどうかを評価することをお勧めします。コネクタがウェアハウスのスケーリングから何かを得るかどうかは、プロパティの数や各プロパティが持つデータ量など、いくつかの要因に依存します。

ウェアハウスのサイズを変更する方法については、 ウェアハウスの操作 の倉庫のサイズを変更するを参照してください。

コネクタのウェアハウスの変更

コネクタを再インストールすることなく、内部タスクに Snowflake Connector for Google Analytics Raw Data が使用するウェアハウスを変更することができます。まず、コネクタが一時停止していることを確認します。UI を介して、または PAUSE_CONNECTOR プロシージャを使用して確認できます。次に、コネクタに新しいウェアハウスへのアクセスを許可する必要があります。

GRANT USAGE ON WAREHOUSE <new_warehouse_name> TO APPLICATION snowflake_connector_for_google_analytics_raw_data;
Copy

アクセスが許可されたら、 PUBLIC スキーマで定義されている UPDATE_WAREHOUSE プロシージャを実行します。

CALL UPDATE_WAREHOUSE('<new_warehouse_name');
Copy

コネクタの再認証コード

再インストールせずにコネクタで使用されるシークレット、外部アクセス統合、またはセキュリティ統合を変更するには、 PUBLIC スキーマで定義されている UPDATE_CONNECTION プロシージャを実行する必要があります。新しいオブジェクトがすべて SQL を使用した Snowflake Connector for Google Analytics Raw Data の構成 の説明どおりに定義され、コネクタに必要なすべての権限の許可が付与されていることを確認します。

CALL UPDATE_CONNECTION('<new external access integration>', '<new secret>', '<new security integration>');
Copy

アクセスできないGoogleアナリティクスプロパティの自動無効化

コネクタには、アクセスできないGoogleアナリティクスのプロパティを自動的に無効にするメカニズムがあり、存在しないデータのインジェスチョンを無期限に試みることによる不必要なコストを防ぎ、データがインジェストされなくなったことをアラームで知らせます。過去7日間、データインジェスチョンが失敗している場合、このプロパティはアクセス不可能とみなされ、自動的に無効になる可能性があります。

障害復旧とフェールオーバー時の手続き

デプロイの停止中にコネクタがデータインジェスチョンを継続できるようにする場合、レプリカアカウントに sink database failover を設定する必要があります。詳細については、 複数のアカウントにまたがるデータベースのフェールオーバー をご参照ください。

さらに、障害発生後は、コネクタ自体を複製できないため、レプリカアカウントに Snowflake Connector for Google Analytics Raw Data を手動でインストールする必要があります。インストール後、複製されたシンクデータベースと同期します。

注釈

データの破損を防ぐため、プライマリアカウントとレプリカアカウントの2つのコネクタインスタンスが同時にシンクデータベースにデータをインジェクトすることはできません。

デプロイの停止が発生し、シンクデータベースがレプリカアカウントにフェールオーバーされた場合は、次の手順を実行します:

  1. シンクデータベースが複製されているセカンダリアカウントにサインインします。

  2. セカンダリアカウントに Snowflake Connector for Google Analytics Raw Data をインストールします。コネクタは複製されたシンクデータベースと同期します。プライマリアカウントのインスタンスは、停止後に読み取り専用状態になるため、この時点でデータが破損することはありません。

  3. デプロイが再び利用可能になった後にプライマリアカウントに戻る場合は、まず両方のコネクタを削除する必要があります。一貫したコネクタの状態を確保するために必要です。

  4. 複製メカニズムを使用して、セカンダリアカウントからプライマリアカウントにデータを複製して戻します。

  5. シンクテーブルのデータがセカンダリアカウントのシンクテーブルと同期したら、プライマリアカウントにコネクタを再インストールします。

データインジェスチョンオプションの更新

PUBLIC スキーマで定義されている UPDATE_INGESTION_OPTIONS プロシージャを使用して、特定のプロパティのデフォルトのインジェスチョンオプションを変更できます。このプロシージャにより、次を変更できるようになります。

  • EXCLUDE_NULLS - インジェストされたデータからNULL値を含むフィールドを削除します。この値を TRUE に設定すると、データインジェスチョンのスループットが向上します。デフォルト値は FALSE です。

  • DISABLE_AUTO_RELOADS - データの自動再ロードを無効にします。自動再ロードの詳細については、 Snowflake Connector for Google Analytics Raw Data のデータインジェスチョンモデル をご参照ください。この値を TRUE に設定すると、クレジットの消費を抑えることができますが、遅れたデータはSnowflakeにインジェストされません。デフォルト値は FALSE です。

CALL UPDATE_INGESTION_OPTIONS(
    PROPERTY_IDS => ['<property_1>', '<property_2>'],
    EXCLUDE_NULLS => <boolean>,
 );
Copy

注釈

インジェスチョンオプションを変更せずに残すには、 UPDATE_INGESTION_OPTIONS プロシージャ呼び出しから引数を省略します。

オンデマンドでフラット化されたビューを更新する

PUBLIC スキーマで定義されている REFRESH_VIEWS プロシージャを使用して、フラット化されたビューのオンデマンド更新をトリガーできます。フラット化されたビューは、デフォルトでは毎日自動的に更新されます。表示の詳細については、 Snowflake Connector for Google Analytics Raw Data によりインジェストされたデータへのアクセス をご参照ください。

CALL REFRESH_VIEWS();
Copy
言語: 日本語