REPLICATION_GROUP_REFRESH_HISTORY, REPLICATION_GROUP_REFRESH_HISTORY_ALL¶

構文¶

REPLICATION_GROUP_REFRESH_HISTORY(
      '<secondary_group_name>'
      [ , DATE_RANGE_START => <constant_expr> ]
      [ , DATE_RANGE_END => <constant_expr> ] )

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

引数¶

'secondary_group_name'

セカンダリグループの名前。名前全体を一重引用符で囲む必要があります。REPLICATION_GROUP_REFRESH_HISTORY には必須です。REPLICATION_GROUP_REFRESH_HISTORY_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_HISTORY_ALL には、結果セットの最初の2列として追加の列が含まれています。

使用上の注意¶

• DATE_RANGE_START または DATE_RANGE_END 引数が指定されていない場合、関数は過去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

例¶

セカンダリグループ myfg の更新履歴を取得するには、以下のステートメントを実行します。

SELECT phase_name, start_time, end_time,
       total_bytes, object_count, error
  FROM TABLE(
      INFORMATION_SCHEMA.REPLICATION_GROUP_REFRESH_HISTORY('myfg')
  );

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

SELECT phase_name, start_time, end_time,
       total_bytes, object_count, error
  FROM TABLE(
      INFORMATION_SCHEMA.REPLICATION_GROUP_REFRESH_HISTORY_ALL()
  );

すべてのグループの過去7日間の更新履歴を取得するには：

SELECT phase_name, start_time, end_time,
       total_bytes, object_count, error
  FROM TABLE(
      INFORMATION_SCHEMA.REPLICATION_GROUP_REFRESH_HISTORY_ALL(
          DATE_RANGE_START => DATEADD(D, -7, CURRENT_DATE),
          DATE_RANGE_END => CURRENT_DATE)
  );

セカンダリグループ myfg の特定の日付範囲の更新履歴を取得するには：

SELECT phase_name, start_time, end_time,
       total_bytes, object_count, error
  FROM TABLE(
      INFORMATION_SCHEMA.REPLICATION_GROUP_REFRESH_HISTORY(
          'myfg',
          DATE_RANGE_START => '2025-04-01',
          DATE_RANGE_END => '2025-04-07')
  );