カテゴリ:

Information Schema、 テーブル関数

REPLICATION_GROUP_REFRESH_PROGRESS, REPLICATION_GROUP_REFRESH_PROGRESS_BY_JOB

Snowflake logo in black (no text) StandardおよびBusiness Criticalの機能

  • データベースおよび共有の複製は、すべてのアカウントで利用できます。

  • 他のアカウントオブジェクトの複製およびフェールオーバー/フェールバックには、Business Critical Edition（またはそれ以上）が必要です。アップグレードについては、 Snowflakeサポート にお問い合わせください。

REPLICATION_GROUP_REFRESH_PROGRESS の関数ファミリを使用して、複製またはフェールオーバーグループの更新のステータスをクエリできます。

  • REPLICATION_GROUP_REFRESH_PROGRESS は、セカンダリ複製またはフェールオーバーグループの更新ステータスを名前別に示す JSON オブジェクトを返します。

  • REPLICATION_GROUP_REFRESH_PROGRESS_BY_JOB は、セカンダリ複製またはフェールオーバーグループの更新ステータスをクエリ ID 別に示す JSON オブジェクトを返します。

注釈

  • REPLICATION_GROUP_REFRESH_PROGRESS は、過去14日以内に発生した場合にのみ、最新の複製またはフェールオーバーグループ更新の更新アクティビティを返します。

  • REPLICATION_GROUP_REFRESH_PROGRESS_BY_JOB 過去14日以内に複製またはフェールオーバーグループ更新の更新アクティビティを返します。

構文

REPLICATION_GROUP_REFRESH_PROGRESS( '<secondary_group_name>' )

REPLICATION_GROUP_REFRESH_PROGRESS_BY_JOB( '<query_id>' )
Copy

引数

secondary_group_name

セカンダリ複製またはフェールオーバーグループの名前。名前全体を一重引用符で囲む必要があります。

query_id

複製グループ更新クエリの ID。クエリ ID は、ウェブインターフェイスの History History tab ページから取得できます。

出力

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

列名

データ型

説明

PHASE_NAME

TEXT

これまでに完了した（または進行中の）複製フェーズの名前。フェーズのリストについては、使用上の注意をご参照ください。

START_TIME

TIMESTAMP_LTZ

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

END_TIME

TIMESTAMP_LTZ

フェーズが終了した時刻（該当する場合）。フェーズが進行中の場合、または終了フェーズの場合（COMPLETED / FAILED / CANCELED）は NULL。

PROGRESS

TEXT

  • PRIMARY_UPLOADING_DATA: 複製された合計バイト数のパーセンテージ。

  • SECONDARY_DOWNLOADING_METADATA: 複製されたオブジェクトの合計数のパーセンテージ。

  • SECONDARY_DOWNLOADING_DATA: 複製された合計バイト数のパーセンテージ。

残りのフェーズは空白です

DETAILS

VARIANT

  • フェーズ PRIMARY_UPLOADING_METADATA の場合:

    • primarySnapshotTimestamp: プライマリスナップショットが作成された時刻。形式はエポック時間です。

  • フェーズ PRIMARY_UPLOADING_DATA の場合:

    • totalBytesToReplicate: アップロードが予想される合計バイト数。

    • totalBytesToUpload: アップロードする必要のある合計バイト数。

    • bytesUploaded: これまでにアップロードされた合計バイト数。

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

      • name: データベース名。

      • totalBytesToReplicate: データベースのためにアップロードが予想される合計バイト数。

  • フェーズ SECONDARY_DOWNLOADING_DATA の場合:

    • totalBytesToReplicate: ダウンロードが予想される合計バイト数。

    • totalBytesToDownload: ダウンロードする必要のある実際のバイト数。

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

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

      • name: データベース名。

      • totalBytesToReplicate: データベースのためにダウンロードが予想される合計バイト数。

  • フェーズ SECONDARY_DOWNLOADING_METADATA の場合:

    • totalObjects: ダウンロードするオブジェクトの合計数。

    • completedObjects: これまでにダウンロードされたオブジェクトの合計数。

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

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

      • totalObjects: この型のオブジェクトの合計数。

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

  • フェーズ FAILED の場合:

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

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

使用上の注意

  • 複製またはフェールオーバーグループに対する権限を持つロールの行のみを返します。

  • 現在のアカウント内にあるセカンダリ複製またはフェールオーバーグループの行のみを返します。

  • Information Schemaテーブル関数を呼び出す場合、セッションには使用中の INFORMATION_SCHEMA スキーマ または 完全修飾の関数名が必要です。詳細については、 Snowflake 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 より小さくなります。

例

rg1 複製グループに対する複製グループ更新の現在の進行状況を取得します。

select *
from table(information_schema.replication_group_refresh_progress('rg1'));
Copy

クエリ ID 別にデータベースリフレッシュの現在の進行状況を取得します。

select *
from table(information_schema.replication_group_refresh_progress_by_job('012a3b45-1234-a12b-0000-1aa200012345'));
Copy
言語: 日本語