REPLICATION_GROUP_REFRESH_PROGRESS, REPLICATION_GROUP_REFRESH_PROGRESS_BY_JOB, REPLICATION_GROUP_REFRESH_PROGRESS_ALL¶

構文¶

REPLICATION_GROUP_REFRESH_PROGRESS( '<secondary_group_name>' )

REPLICATION_GROUP_REFRESH_PROGRESS_BY_JOB( '<query_id>' )

REPLICATION_GROUP_REFRESH_PROGRESS_ALL(
      [ DATE_RANGE_START => <constant_expr> ]
      [ , DATE_RANGE_END => <constant_expr> ] )

引数¶

'secondary_group_name'

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

'query_id'

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

REPLICATION_GROUP_REFRESH_PROGRESS_ALLでは、次の引数はオプションです。

DATE_RANGE_START => constant_expr、 . DATE_RANGE_END => constant_expr

複製更新の進捗状況を返す日付/時刻範囲。

• 開始日も終了日も指定されていない場合、過去12時間がデフォルトです。

• 開始日は指定されているが、終了日は指定されていない場合は、:doc:`/sql-reference/functions/current_date`の午前0時が範囲の終了として使用されます。

• 終了日は指定されているが、開始日は指定されていない場合、範囲は:samp:`DATE_RANGE_END`の開始12時間前に開始します。

データは14日間保持されます。リクエストされた範囲が14日の保持期間を超えている場合、関数はエラーを返します。

出力¶

この関数は、次の列を返します。REPLICATION_GROUP_REFRESH_PROGRESS_ALL には、結果セットの最初の2列として追加の列が含まれています。

使用上の注意¶

• ``DATE_RANGE_START``または``DATE_RANGE_END``引数が提供されない場合、REPLICATION_GROUP_REFRESH_PROGRESS_ALLは過去12時間のデータを返します。過去12時間を超えるデータを取得するには、日付範囲を明示的に指定します。データは最大14日間利用できます。

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

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

• 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	更新処理のステータス。

  See moreShow less

  Expand

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

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

例¶

複製グループ rg1 の現在の更新進捗状況を取得するには、以下のステートメントを実行します。

SELECT phase_name, start_time, end_time, progress, details
  FROM TABLE(INFORMATION_SCHEMA.REPLICATION_GROUP_REFRESH_PROGRESS('rg1'));

クエリ ID によって複製グループの更新進捗状況を取得するには、例のクエリ ID を置き換えて、以下のステートメントを実行します。

SELECT phase_name, start_time, end_time, progress, details
  FROM TABLE(
    INFORMATION_SCHEMA.REPLICATION_GROUP_REFRESH_PROGRESS_BY_JOB(
      '012a3b45-1234-a12b-0000-1aa200012345'));

すべてのフェールオーバーグループと複製グループの過去12時間（デフォルト）の更新進捗状況を取得するには、以下のステートメントを実行します。

SELECT phase_name, start_time, end_time, progress, details
  FROM TABLE(INFORMATION_SCHEMA.REPLICATION_GROUP_REFRESH_PROGRESS_ALL());

すべてのグループの過去7日間の更新進捗状況を取得するには：

SELECT phase_name, start_time, end_time, progress, details
  FROM TABLE(
    INFORMATION_SCHEMA.REPLICATION_GROUP_REFRESH_PROGRESS_ALL(
        DATE_RANGE_START => DATEADD(D, -7, CURRENT_DATE),
        DATE_RANGE_END => CURRENT_DATE));