ストリームを変更する

ストリームに関する次の情報を変更できます。

• ストリームの表示名やラベルなどの概要情報。

• Datastream が移行先に転送するか、移行先への転送が制限される移行元データベースのテーブルやスキーマなどの、移行元データベースと移行先の構成情報。Datastream は、この構成情報を使用して正しいデータを移行元データベースから移行先に転送します。

  注: 作成済みのストリームの移行元データベースのタイプは変更できません。データベースのタイプを変更するには、新しいストリームを作成する必要があります。詳細については、ルールセットを作成するをご覧ください。

概要情報の変更

1. コンソールの [ストリーム] ページに移動します。 Google Cloud

   [ストリーム] ページに移動

2. 変更するストリームをクリックします。

3. [ストリームの詳細] ページで、[編集] をクリックします。

4. 表示されるメニューから [ストリーム設定を編集] を選択します。

5. ストリームの表示名またはラベルを変更します。

   ストリームの表示名またはラベルの詳細については、ストリームの設定を定義するをご覧ください。

6. 変更が完了したら、[保存] をクリックします。

ソースのデータベースの構成情報を変更する

1. コンソールの [ストリーム] ページに移動します。 Google Cloud

   [ストリーム] ページに移動

2. 変更するストリームをクリックします。

3. [ストリームの詳細] ページで、[編集] をクリックします。

4. 表示されるメニューから、[ソースの構成を編集] を選択します。

5. [含めるオブジェクトを選択] セクションで、[含めるオブジェクト] プルダウン メニューを使用して、DataStream が移行先に転送する移行元データベースのテーブルとスキーマを変更します。

6. 必要に応じて、[除外するオブジェクトを選択] ノードを展開します。[除外するオブジェクト] フィールドで、Datastream による宛先への転送を制限するソース データベース内のテーブルとスキーマを変更します。このリストにテーブルが追加されると、テーブルとスキーマは宛先に pull されなくなります。ただし、宛先から削除されることはありません。

   [
   **含めるオブジェクト**] メニューまたは [**除外するオブジェクト**] フィールドの詳細については、ストリームの移行元データベースに関する情報の構成をご覧ください。

7. Oracle ソースの場合、CDC メソッドは変更できません。ただし、このログファイル アクセス タイプを選択した場合は、データベース ディレクトリの詳細を変更できます。

8. 必要に応じて、[履歴データのバックフィル モードを選択する] ノードを展開して、Datastream の移行先に過去のデータと将来のデータをバックフィルするか、このデータへの変更のみをストリーミングするかを変更します。

   • データの変更に加えて、既存のすべてのデータを移行先にストリーミングするには、[自動] オプションを選択します。

     このオプションを選択すると、[自動バックフィルから除外されたオブジェクト] フィールドで、移行元データベース内のテーブルとスキーマを変更して、DataStream が移行先にバックフィルするのを制限できます。

   • データの変更のみをストリーミングするには、[手動] オプションを選択します。

     [履歴データのバックフィル モードを選択する] ノードの詳細については、ストリームの移行元データベースに関する情報の構成をご覧ください。

9. 変更が完了したら、[保存] をクリックします。

転送先の構成情報を変更する

1. コンソールの [ストリーム] ページに移動します。 Google Cloud

   [ストリーム] ページに移動

2. 変更するストリームをクリックします。

3. [ストリームの詳細] ページで、[編集] をクリックします。

4. 表示されるメニューから、[移行先の構成を編集] を選択します。

5. 選択した宛先に応じて、必要に応じて次の設定を調整します。

   BigQuery の宛先:

   • [暗号化] で、使用する暗号化のタイプを変更します。 Google-managed encryption key または Cloud Key Management Service 鍵。
   • [データ未更新と BigQuery の費用のバランスを取る] で、[未更新に関する制限事項] オプションを変更します。
   注意: 現在の未更新に関する制限事項の構成は、Datastream によって作成された新しい BigQuery テーブルにのみ適用されます。テーブルの作成日によっては、未更新に関する制限事項が異なる場合があります。既存のテーブルに正しい未更新に関する制限事項を適用するには、対応するストリームを再作成するか、ALTER TABLE ステートメントを使用して各テーブルを変更することを検討してください。

   Apache Iceberg テーブル の宛先:

   • [暗号化] で、使用する暗号化のタイプを変更します。 Google-managed encryption key または Cloud Key Management Service 鍵。

   Cloud Storage の宛先:

   • [ストリームのパス接頭辞] フィールドで、Datastream が移行元データベースからスキーマ、テーブル、データを転送する移行先のフォルダを変更します。
     フォルダを変更すると、新しいファイルはすべて新しいフォルダに書き込まれます。また、[ストリームのパス接頭辞] フィールドの詳細については、ストリームの宛先に関する情報を構成するをご覧ください。
   • [出力形式] メニューから:
     • Cloud Storage に書き込まれるファイルのフォーマットを選択します。Datastream は、Avro と JSON の 2 つの出力形式をサポートしています。
     • JSON 形式を選択する場合は、[ファイルパスに統合型スキーマ ファイルを含める] と [gzip 圧縮を有効にする] のチェックボックスを選択または選択解除します。
       これらのチェックボックスの詳細については、ストリームの移行先に関する情報を構成するをご覧ください。

6. [**保存**] をクリックして変更を適用し、ストリームを開始します。実行中のストリームに対して行った変更は、Datastream によって自動的に更新されます。

次のステップ

• ストリームの詳細については、ストリームのライフサイクルをご覧ください。
• ストリームをモニタリングする方法については、ストリームをモニタリングするをご覧ください。
• ストリームに関する情報を表示する方法については、ストリームを表示するをご覧ください。
• 失敗したストリームを復元する方法については、ストリームを復元するをご覧ください。
• 既存のストリームを削除する方法については、ストリームを削除するをご覧ください。