ストリームを変更する

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 によって自動的に更新されます。

次のステップ

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