カテゴリ：

Information Schema、 テーブル関数

LISTING_REFRESH_HISTORY

クロスクラウド自動複製リストの過去14日間のリフレッシュ履歴を返します。返される情報には、リストが指定されたターゲットリージョンに同期される更新イベントの複製詳細が含まれます。

この関数は、指定されたリストに何らかの権限を持つリストのプロバイダーが利用できます。

構文

LISTING_REFRESH_HISTORY(
  LISTING_NAME => '<listing_name>'
  [ , SNOWFLAKE_REGION => '<snowflake_region>' ]
  [ , REGION_GROUP => '<region_group>' ] )
Copy

引数

必須

LISTING_NAME => 'listing_name'

このアカウントのクロスクラウド自動複製リストの SQL 識別子。リストの SQL 識別子は、データ交換<変換名>のリスト表示で返される名前列で見つけることができます。同様に、データ交換のための SQL 識別子は、 show data exchanges が返す名前列で見つけることができます。

オプション

SNOWFLAKE_REGION => 'snowflake_region'

リストが複製されるSnowflakeリージョングループで、その複製のリフレッシュ履歴を表示できます。これは、 SHOW REGIONS が返す列 snowflake_region と同じ形式に従います。リージョンが指定されていない場合は、すべてのターゲットリージョンの履歴が表示されます。

REGION_GROUP =>  'region_group'

リストが複製されるSnowflakeリージョングループで、リフレッシュ履歴を表示できます。

デフォルトでは、 PUBLIC です。この引数を指定する必要があるのは、モニターのターゲットリージョンが US 政府またはVirtual Private Snowflakeリージョンの場合のみです。

出力

この関数は、次の列を返します。

列名

データ型

説明

LISTING_NAME

TEXT

このアカウントのクロスクラウド自動複製リストの名前。

SNOWFLAKE_REGION

TEXT

リストが複製されるSnowflakeリージョンの名前。例: aws_us_east_1。

REGION_GROUP

TEXT

リストが複製されるSnowflakeリージョングループの名前。例: PUBLIC。

PHASE

TEXT

複製操作の現在のフェーズ。合計X個のフェーズのうちの1つのフェーズとして表されます。たとえば、2/6。

PHASE_NAME

TEXT

これまでに完了した（または進行中の）複製フェーズの名前。

フェーズのリストについては、 使用上の注意 をご参照ください。

PROGRESS

TEXT

現在の複製進捗率をパーセントで示します。

START_TIME

TIMESTAMP_LTZ

複製フェーズが開始された時刻。

END_TIME

TIMESTAMP_LTZ

フェーズが終了した時間（該当する場合）。

フェーズが進行中であるか、終了フェーズ（COMPLETED/FAILED/CANCELED）である場合は NULL。

JOB_UUID

TEXT

更新ジョブのクエリ ID。

TOTAL_BYTES

VARIANT

更新されたデータベースに関する詳細情報を提供する JSON オブジェクト:

  • totalBytesToReplicate: 複製が予想される合計バイト数。

  • bytesUploaded: 実際にアップロードされたバイト数。

  • bytesDownloaded: 実際にダウンロードされたバイト数。

  • databases: 各メンバーデータベースの次のフィールドを含む JSON オブジェクトのリスト:

    • name: データベースの名前。

    • totalBytesToReplicate: データベースのために複製が予想される合計バイト数。

OBJECT_COUNT

VARIANT

更新されたオブジェクトに関する詳細情報を提供する JSON オブジェクト:

  • totalObjects: 複製またはフェールオーバーグループ内にあるオブジェクトの合計数。

  • completedObjects: 完了したオブジェクトの合計数。

  • objectTypes: 型ごとに次のフィールドを含む JSON オブジェクトのリスト:

    • objectType: オブジェクトの型（例: ユーザー、ロール、付与、ウェアハウス、スキーマ、テーブル、列など）。

    • totalObjects: 複製またはフェールオーバーグループ内にあるこの型のオブジェクトの合計数。

    • completedObjects: 完了したこの型のオブジェクトの合計数。

PRIMARY_SNAPSHOT_TIMESTAMP

TIMESTAMP_LTZ

プライマリスナップショットが作成されたときのタイムスタンプ。

ERROR

VARIANT

更新操作に成功した場合は NULL。更新操作に失敗した場合は、エラーに関する詳細情報を提供する JSON オブジェクトを返します。

  • errorCode: 失敗のエラーコード。

  • errorMessage: 失敗のエラーメッセージ。

使用上の注意

  • リストに何らかの権限を持つロールの行のみを返します。

  • 現在のアカウントにあるリストの行のみを返します。

  • Information Schemaテーブル関数を呼び出す場合、セッションには使用中の INFORMATION_SCHEMA スキーマまたは完全修飾の関数名が必要です。

    詳細については、 Information Schema をご参照ください。

  • 処理された順番のフェーズリスト。

    1. SECONDARY_SYNCHRONIZING_MEMBERSHIP

    2. SECONDARY_UPLOADING_INVENTORY

    3. PRIMARY_UPLOADING_METADATA

    4. PRIMARY_UPLOADING_DATA

    5. SECONDARY_DOWNLOADING_METADATA

    6. SECONDARY_DOWNLOADING_DATA

    7. COMPLETED / FAILED / CANCELED

  • 出力には、同じデータベースを参照している他のリストの履歴も含まれます。入力がアプリケーションリストの場合、指定されたリージョンにあるすべてのアプリケーションリストの履歴が含まれます。

  • PRIMARY_UPLOADING_DATA および SECONDARY_DOWNLOADING_DATA フェーズでは、複製操作の前に totalBytesToReplicate 値が推定されます。この値は、それぞれのフェーズの totalBytesToUpload または totalBytesToDownload の値とは異なる場合があります。

    たとえば、 PRIMARY_UPLOADING_DATA フェーズ中に以前の複製操作で数バイトがアップロードされ、操作が完了する前にキャンセルされた場合、それらのバイトは再度アップロードされません。その場合、 totalBytesToUpload は totalBytesToReplicate より小さくなります。

例

パブリッククラウドのリージョンである AWS US East-1にリフレッシュするリスト my_listing の履歴を取得します。

select * from table(information_schema.listing_refresh_history(listing_name=>'my_listing',snowflake_region=>'AWS_US_EAST_1))
Copy
言語: 日本語