データベースの複製の考慮事項¶

プライマリデータベースの外部テーブル¶

現在、プライマリデータベースの外部テーブルが原因で、複製または更新操作は失敗し、次のエラーメッセージが表示されます。

003906 (55000): SQL execution error:
Primary database contains an external table '<database_name>'.Replication of a database with external table is not supported

この制限を回避するには、外部テーブルを複製されていない別のデータベースに移動することをお勧めします。または、データベースを別のアカウントに移行する場合は、プライマリデータベースのクローンを作成し、クローンから外部テーブルを削除してから、クローンデータベースを複製することができます。ターゲットアカウントでセカンダリデータベースを昇格した後、データベースに外部テーブルを再作成する必要があります。

セカンダリデータベースの外部テーブル¶

外部テーブルが以前プライマリデータベースであり、その間に外部テーブルが作成された場合、外部テーブルはセカンダリデータベースに存在できます。別のデータベースが指定されたプライマリデータベースに昇格すると、そのデータベースはセカンダリデータベースになります。現在、セカンダリデータベースの外部テーブルが原因で、更新操作は失敗し、次のエラーが発生します。

003958 (55000): SQL execution error:
Secondary database contains an external table '<table_name>'. Replication of a database with external table is not supported.

この制限を回避するには、複製されたセカンダリデータベースではない別のデータベースに外部テーブルを移動するようにお勧めします。

ストリームでサポートされるソースオブジェクト¶

複製されたストリームは、同じデータベース内のテーブルとビューの変更データを正常に追跡できます。

現在、次のソースオブジェクト型はサポート されていません。

• ディレクトリテーブル

• 外部テーブル

• ストリームデータベースとは別のデータベース内にあるテーブルまたはビュー。

  この設計は、ストリームデータベースとソースオブジェクトを格納するデータベースの両方が同じ 複製グループまたはフェールオーバーグループ に含まれている 場合 に機能します。

• 共有データベースのテーブルまたはビュー（つまり、プロバイダーアカウントから自分のアカウントに共有されるデータベース）

サポートされていないソースオブジェクトを含むストリームがプライマリデータベースに含まれている場合は、データベースの複製または更新操作に失敗します。いずれかのストリームのソースオブジェクトがドロップされている場合も、操作に失敗します。

データ重複の回避¶

DML 操作が一意性チェックなしでストリームから同じ変更データを複数回書き込むと、データの重複が発生します。これが発生する可能性があるのは、ストリームとストリーム変更データの宛先テーブルが別々のデータベースに格納されており、これらのデータベースが複製されず、同じグループでフェールオーバーされた場合です。

たとえば、ストリーム s からテーブル dt に変更データを定期的に挿入するとします。（この例では、ストリームのソースオブジェクトは重要ではありません。）個別のデータベースには、ストリームと宛先テーブルが格納されます。

1. タイムスタンプ t1 で、ストリーム s のソーステーブルに行が挿入され、新しいテーブルバージョンが作成されます。ストリームは、このテーブルバージョンのオフセットを格納します。

2. タイムスタンプ t2 で、ストリームを格納するセカンダリデータベースが更新されます。複製されたストリーム s にオフセットが格納されるようになりました。

3. タイムスタンプ t3 で、ストリーム s の変更データがテーブル dt に挿入されます。

4. タイムスタンプ t4 で、ストリーム s を格納するセカンダリデータベースがフェールオーバーされます。

5. タイムスタンプ t5 で、ストリーム s の変更データがテーブル dt に再度挿入されます。

この状況を回避するには、ストリームとその宛先テーブルを格納するデータベースを一緒に複製してフェールオーバーします。

タスク WHEN 句でのストリーム参照¶

WHEN boolean_expr 句でストリームを参照する、複製されたタスクを実行するときの予期しない動作を回避するには、次のいずれかを実行するようにお勧めします。

• タスクとストリームを同じデータベースに作成する。 または

• ストリームを参照するタスクとは別のデータベースにストリームが格納されている場合は、両方のデータベースを同じ フェールオーバーグループ に含める。

タスクが別のデータベースのストリームを参照し、両方のデータベースが同じフェールオーバーグループに含まれていない場合、タスクを含むデータベースは、ストリームを含むデータベースなしでフェールオーバーされる可能性があります。このシナリオでは、フェールオーバーされたデータベースでタスクが再開され、タスクを実行しようとするとエラーが記録され、参照されたストリームを検出することができません。この問題は、ストリームを含むデータベースをフェールオーバーするか、タスクを含むフェールオーバーされたデータベースと同じアカウント内で、データベースとストリームを再作成することにより解決できます。

ストリームの陳腐化¶

プライマリデータベースのストリームが 古くなった 場合、セカンダリデータベースの複製されたストリームも古くなり、クエリを実行したり、その変更データを消費したりできなくなります。この問題を解決するには、プライマリデータベースでストリームを再作成します （CREATE OR REPLACE STREAM を使用）。セカンダリデータベースが更新されると、複製されたストリームは再び読み取り可能になります。

再作成されたストリームのオフセットは、デフォルトで現在のテーブルバージョンになることに注意してください。Time Travelを使用して、以前のテーブルバージョンをポイントするストリームを再作成できます。ただし、複製されたストリームは読み取れないままになります。詳細については、 ストリーム複製およびTime Travel （このトピック内）をご参照ください。

ストリーム複製およびTime Travel¶

プライマリデータベースがフェールオーバーされた後、データベースのストリームが Time Travel を使用して、ソースオブジェクトの テーブルバージョン を最後の更新タイムスタンプより前の時点から読み取ると、複製されたストリームをクエリしたり、変更データを消費したりすることができません。同様に、 SELECT ステートメントの CHANGES 句を使用して、最後の更新タイムスタンプより前の時点からソースオブジェクトの変更データをクエリすると、エラーをともない失敗します。

これは、更新操作によってテーブル履歴が1つのテーブルバージョンに折りたたまれるためです。更新操作のタイムスタンプより前に作成された反復テーブルバージョンは、複製されたソースオブジェクトのテーブル履歴に保存されません。

次の例を考えてみましょう：

1. テーブル t1 がプライマリデータベースに作成され、変更追跡が有効になっています（テーブルバージョン tv0）。後続の DML トランザクションは、テーブルバージョン t1 および t2 を作成します。

2. テーブル t1 を含むセカンダリデータベースが更新されます。この複製されたテーブルのテーブルバージョンは t2 です。ただし、テーブル履歴は複製されません。

3. Time Travelを使用して、オフセットをテーブルバージョン tv1 に設定したプライマリデータベースにストリームが作成されます。

4. セカンダリデータベースがフェールオーバーされ、プライマリデータベースになります。

5. テーブルバージョン tv1 がテーブル履歴にないため、ストリーム s1 をクエリするとエラーが返されます。

テーブル t1 の後続の DML トランザクションがテーブルバージョンを tv3 に反復すると、ストリーム s1 のオフセットが進むことに注意してください。ストリームは再び読み取り可能になります。

データ損失の回避¶

フェールオーバー操作の前にセカンダリデータベースの最新の更新操作が完了すると、データが失われる可能性があります。リスクを最小限に抑えるために、セカンダリデータベースを頻繁に更新することをお勧めします。

ストリーム複製を有効にする¶

ストリーム複製のプレビューを有効にするには、 ストリームとタスクの複製のプレビューを有効にする --- オプション をご参照ください。

複製のシナリオ¶

次のテーブルでは、さまざまなタスクシナリオについて説明し、タスクが複製されるかどうかを示します。特に断りのない限り、シナリオはスタンドアロンタスクと DAG 内のタスクの両方に関係します。

複製されたタスクの再開または一時停止の状態¶

次の条件がすべて満たされている場合、タスクは再開された状態でセカンダリデータベースに複製されます。

• スタンドアロンまたはルートタスクは、複製または更新操作が開始されると、操作が完了するまで、プライマリデータベースで再開された状態になります。タスクがこの期間の一部だけ再開状態にある場合でも、再開状態で複製される可能性があります。

  子タスクは、タスクの最新バージョンで再開された状態にあります。

• 親データベースは、同じまたは異なる 複製グループまたはフェールオーバーグループ 内のロールオブジェクトとともに、ターゲットアカウントに複製されました。

  ロールとデータベースが複製された後、 ALTER REPLICATION GROUP ... REFRESH または ALTER FAILOVER GROUP ... REFRESH をそれぞれ実行して、ターゲットアカウントのオブジェクトを更新する必要があります。 ALTER DATABASE ... REFRESH を実行してデータベースを更新すると、データベース内のタスクの状態が一時停止に変更されます。

  複製または更新操作には、最新のテーブルバージョンがコミットされた時点で最新であったタスクの権限付与が含まれます。詳細については、 複製されたタスクと権限付与 （このトピック内）をご参照ください。

これらの条件が満たされない場合、タスクは一時停止状態でセカンダリデータベースに複製されます。

複製されたタスクと権限付与¶

親データベースが、同じまたは異なる複製グループやフェールオーバーグループ内のロールオブジェクトと共にターゲットアカウントに複製される場合は、データベース内のタスクに付与された権限も同様に複製されます。

次のロジックにより、複製または更新操作で複製されるタスク権限が決定されます。

• 現在のタスク所有者（つまり、タスクに対する OWNERSHIP 権限を持つロール）が、最後にタスクが再開されたときと同じロールである場合は、タスクに対する現在のすべての権限がセカンダリデータベースに複製されます。

• 現在のタスクの所有者が、最後にタスクが再開されたときと同じロール ではない 場合は、タスクバージョンで所有者のロールに付与された OWNERSHIP 権限のみがセカンダリデータベースに複製されます。

• 現在のタスク所有者ロールが使用できない場合（例: 子タスクがドロップされたが、新しいバージョンのタスク DAG がまだコミットされていない場合）は、タスクバージョンで所有者ロールに付与された OWNERSHIP 権限のみがセカンダリデータベースに複製されます。

フェールオーバー後にタスクが実行される¶

セカンダリフェールオーバーグループがプライマリグループとして機能するように昇格された後、フェールオーバーグループ内のデータベースで再開されたタスクは、段階的にスケジュールされます。再開されたすべてのスタンドアロンタスクと DAGs の通常のスケジュールを復元するために必要な時間は、データベース内にある再開されたタスクの数によって異なります。

タスク複製を有効にする¶

タスク複製のプレビューを有効にするには、 ストリームとタスクの複製のプレビューを有効にする --- オプション をご参照ください。

別のデータベース内のオブジェクトへの参照¶

プライマリデータベースのビューまたはテーブル制約が別のデータベースを参照しているかどうかを慎重に分析します。

ビュー

• このタイプの参照は名前ベースであるため、別のデータベース内のオブジェクトを参照する非マテリアライズドビュー（例：テーブル列、他のビュー、 UDFs、またはステージ）を複製できます。名前ベースの参照によって複製が失敗することはありません。ただし、他のデータベースが同じリージョンに複製されていない場合、セカンダリデータベースのビューに対するクエリは失敗します。

  たとえば、データベース d1 のビュー v1 が、データベース d1 と d2 のテーブル t1 と t2 をそれぞれ参照するとします。セカンダリデータベース d1 のビューV1を正常にクエリするには、セカンダリデータベース d2 もアカウントに存在する必要があります（例: 別のセカンダリデータベースとして）。さらに、プライマリデータベースとの一貫したクエリ結果を得るには、セカンダリデータベース d1 と d2 を同時に更新する必要があります。

• マテリアライズドビューでダングリング参照があると、複製に失敗し、次のエラーメッセージが表示される場合があります。

  Dangling references in the snapshot. Correct the errors before refreshing again. The following references are missing (referred entity <- [referring entities])
  

  これらのダングリング参照は、次の場合に発生する可能性があります。

  • マテリアライズドビューが別のデータベース内にある任意のオブジェクトを参照する。

    マテリアライズドビューは、オブジェクトを名前ではなく ID で参照します。データベーススナップショットは、データベース外部のオブジェクトへの ID ベースの参照を解決できません。

    別のデータベースにあるオブジェクトへのダングリング参照を避けるために、マテリアライズドビューとそれらが参照するオブジェクトを同じデータベースに格納することをお勧めします。

  • マテリアライズドビューが無効である（つまり、 ドロップされたオブジェクト を参照している）。

    無効なマテリアライズドビューのダングリング参照エラーを回避するには、マテリアライズドビューの問題を特定して修正します。マテリアライズドビューのトピック内の トラブルシューティング セクションをご参照ください。

制約

現在、外部キーをダングリングすると複製に失敗し、次のエラーメッセージが表示されます。

Dangling references in the snapshot. Correct the errors before refreshing again. The following references are missing (referred entity <- [referring entities])

この状況は、プライマリデータベースの外部キーが別のデータベースの主キーを参照する場合、またはその逆の場合に発生します。これは、制約参照が ID ベースであるためです。データベーススナップショットは、独自のデータベース外にあるオブジェクトへの ID ベースの参照を解決できません。

アカウントの外部キー参照を表示するには、Information Schemaまたは ACCOUNT_USAGE スキーマにある TABLE_CONSTRAINTS ビューをクエリします。

この制限を回避するために、リンクされたテーブルは同じデータベースに保存することをお勧めします。

シーケンス

現在、シーケンスをダングリングすると複製に失敗し、次のエラーメッセージが表示されます。

Dangling references in the snapshot. Correct the errors before refreshing again. The following references are missing (referred entity <- [referring entities])

この状況は、プライマリデータベースのテーブルが別のデータベースのシーケンスを参照している場合に発生します。これは、シーケンス参照が ID ベースであるためです。データベーススナップショットは、独自のデータベース外にあるオブジェクトへの ID ベースの参照を解決できません。

この制限を回避するために、シーケンスは同じデータベースで参照することをお勧めします。

ポリシーおよびタグ

マスキングポリシー、 行アクセスポリシー、または タグ の参照をダングリングすると複製に失敗し、次のエラーメッセージが表示されます。

Dangling references in the snapshot. Correct the errors before refreshing again. The following references are missing (referred entity <- [referring entities])

この状況は、ポリシー/タグと、ポリシー/タグが割り当てられているオブジェクトが異なるデータベースに存在する場合に発生します。たとえば、 db1.s1.t1 という名前のテーブル、 db2.s1.rap1 という名前の行アクセスポリシー、および行アクセスポリシーがテーブルに割り当てられます。

このダングリングリファレンス動作は、データベース複製に適用されます。

これを回避するには、 複製グループ を使用してデータベースを複製します。

ネットワークポリシー が アカウント複製およびフェールオーバー のコンテキストでユーザーに割り当てられている場合にも、ダングリングリファレンスが発生する可能性があります。詳細については、 ネットワークポリシー複製 をご参照ください。

ドロップされたオブジェクトへの参照¶

同じデータベースまたは別のデータベース内の別のオブジェクトによって参照されているオブジェクトを削除すると、ダングリングリファレンスを引き起こします。プライマリデータベース内のオブジェクトが削除されたオブジェクトを参照すると、レプリケーション操作が失敗し、次のエラーメッセージが表示されます。

Dangling references in the snapshot. Correct the errors before refreshing again. The following references are missing (referred entity <- [referring entities])

この制限を回避するには、次のステップのいずれか 1つ を完了することをお勧めします。

• 削除された参照されているオブジェクトを復元します。

• 参照するオブジェクトを変更します（例: ALTER MATERIALIZED VIEW を使用してマテリアライズドビューを変更）。別のオブジェクトを参照するか、ドロップされたオブジェクトへの参照を削除します。

• ドロップされたオブジェクトを参照するオブジェクトをプライマリデータベースでドロップします。