Snowflake Connector for Google Analytics Aggregate Data のトラブルシューティング

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

このトピックでは、 Snowflake Connector for Google Analytics Aggregate Data の問題をトラブルシューティングするためのガイドラインを提供します。

get_troubleshooting_dataプロシージャの呼び出し

GET_TROUBLESHOOTING_DATA プロシージャは、コネクタの構成、インジェクション履歴、エラー、および問題の根本原因を特定するのに役立つ追加情報に関する情報を返します。このプロシージャは、どのような状態(構成済み、未構成、実行中、一時停止中など)のコネクタでも呼び出すことができます。

注釈

コネクタの問題をsnowflakeサポートに報告するには、この手順の出力を添付してください。

GET_TROUBLESHOOTING_DATA は、'from' タイムスタンプと 'to' タイムスタンプの2つのパラメーターを取ります。これらは、返される行を関連する時間枠に制限します。たとえば、過去1週間のインジェスチョン履歴を持つトラブルシューティングデータを取得するには、次のように呼び出します。

CALL GET_TROUBLESHOOTING_DATA(DATEADD(day, -7, SYSDATE()), SYSDATE());
Copy

Googleアナリティクスへの接続の確認

コネクタがGoogleアナリティクスのデータにアクセスできることを確認するには、コネクタのインストールデータベースの PUBLIC スキーマで定義されている TEST_CONNECTION ストアドプロシージャを呼び出します。

CALL TEST_CONNECTION();
Copy

コネクタ統計およびコネクタエラービューの確認

データインジェスチョンで問題が発生した場合は、コネクタのインストールデータベースで PUBLIC スキーマの CONNECTOR_STATS ビューと CONNECTOR_ERRORS ビューを確認できます。

SELECT * FROM PUBLIC.CONNECTOR_STATS;
SELECT * FROM PUBLIC.CONNECTOR_ERRORS;
Copy

返されるコンテキストについては、 Snowflake Connector for Google Analytics Aggregate Data のモニター をご参照ください。

宛先スキーマのテーブルとビューの所有権の譲渡

コネクタは、関連付けられているすべてのレポートテーブルとビューを所有している必要があります。所有権が他のロールに譲渡された場合、 SYSTEM$GRANT_OWNERSHIP_TO_APPLICATION 関数を使用してコネクタに戻すことができます。

USE ROLE accountadmin;
CALL SYSTEM$GRANT_OWNERSHIP_TO_APPLICATION(<connector_app>, true, <destination_database>, <destination_schema>);
Copy

SYSTEM$GRANT_OWNERSHIP_TO_APPLICATION は、Snowflakeが提供するシステム関数で、指定したデータベースやスキーマのテーブルやビューの所有権をアプリケーションに譲渡することができます。譲渡されるのは、通常のテーブルと通常のビューの所有権のみです。たとえば、動的テーブル、外部テーブル、マテリアライズドビューなどの所有権は譲渡されません。

この関数の署名は以下のとおりです。

SYSTEM$GRANT_OWNERSHIP_TO_APPLICATION(<to_app>, <should_copy_grants>, <from_database>, <from_schema>)
Copy

条件:

to_app

オブジェクトの所有権を譲渡するアプリケーションの名前を指定します。

should_copy_grants

TRUE の場合は既存の権限許可をコピーし、そうでない場合は取り消します。権限許可のコピーには、呼び出し側に MANAGE GRANTS の権限が必要です。

from_database

所有者が変更されるべきオブジェクトを含むデータベースの名前。

from_schema

(オプション)所有者を変更すべきオブジェクトを含むスキーマの名前。スキーマが指定されていない場合、提供されたデータベース内のすべてのスキーマのテーブルとビューの所有権が譲渡されます。管理されたスキーマのオブジェクトは、所有権の譲渡時に省かれます。

この関数を実行するには、呼び出し元が以下のいずれかの条件を満たしている必要があります。

  • MANAGE GRANTS (例: ACCOUNTADMIN または SECURITYADMIN ロール)の権限がある、または

  • アプリケーションインスタンスを所有するロールと、所有権を譲渡するすべてのオブジェクトを所有するロールが含まれている。所有権がないオブジェクトは、関数によって省かれます。

たとえば、次の場合にコネクタに所有権を返すとします。

  • snowflake_connector_for_google_analytics_aggregate_data としてインストールされている

  • SnowflakeのGoogle Analyticsデータの dest_db.dest_schema という名前のスキーマを使用している

次のコマンドを実行します。

USE ROLE accountadmin;
CALL SYSTEM$GRANT_OWNERSHIP_TO_APPLICATION('snowflake_connector_for_google_analytics_aggregate_data', true, 'dest_db', 'dest_schema');
Copy