データ・ストリーム構成の前提条件
データ・ストリームを作成する前に、次の準備を完了してください。ほとんどの接続およびペイロードの問題は、WebSocketコードではなく、ソース証跡、セキュリティ構成またはコンシューマ・チェックポイントの設計で発生します。
実装のチェックリスト
Oracle GoldenGateでデータ・ストリームを構成する前に、次のアクションが実行されていることを確認します。
-
実行中のExtractまたはアップストリームのGoldenGateプロセスは、必要な表および操作をDistribution Serviceが読み取ることができる証跡に書き込みます。
-
このトレイルには、消費者の停止とリカバリの期間が最長になるまで十分な履歴が保持されます。
-
サプリメンタル・ロギングおよびExtract構成では、コンシューマに必要なビフォア・イメージ、キー列、LOB値、DDL、トークンおよびその他のデータが取得されます。
-
データ・ストリーム名、ソース証跡名およびオプションの証跡サブディレクトリがわかります。
-
クライアントは、必要なポートでDistribution ServiceまたはManaged-serviceエンドポイントを解決して到達できます。
-
クライアントは
wssのサーバー証明書チェーンを信頼し、相互TLSが必要な場合にはクライアント証明書を使用できます。 -
必要なロールを持つGoldenGateアカウントは、REST管理およびWebSocket認証に使用できます。
-
コンシューマには、永続チェックポイント記憶域と、冪等またはアトミック・ダウンストリーム書込みの戦略があります。
-
ペイロード・サイズ、LOB処理、スキーマの進化およびCloudEvents要件は、ダウンストリーム所有者と合意されています。
REST APIロール
次の表に、データ・ストリームを構成するために様々なアクションを実行するために必要な権限を示します:
| オペレーション | 最小ロール |
|---|---|
| データ・ストリームのリスト | ユーザー |
| AsyncAPI YAMLの取得 | ユーザー |
| データ・ストリーム構成の取得 | 演算子 |
| データ・ストリームの作成、更新または削除 | 管理者 |
| AsyncAPI YAMLを更新します | 管理者 |
ソース証跡の要件
データ・ストリームは、ソース証跡に存在する情報のみを公開できます。データ・ストリームの作成では、ソース・ロギングの追加、ビフォア・イメージの再構築、Extractが取得しなかった列のリカバリは行われません。コンシューマをデバッグする前に、証跡の内容を確認します。
| コンシューマ要件 | ソース側の要件 |
|---|---|
| イメージの前後の完全な行 | 証跡に必要な列が含まれるように、データベース・ロギングおよびExtractイメージ・オプションを構成します。 |
| 信頼できるIDの更新/削除 | 主キー、一意キーまたは承認されたGoldenGateキー列を取得します。 |
| DDLイベント | ソースおよびExtract構成のDDL取得を有効化および検証します。 |
| 大きいLOB値 | LOBデータを取得し、データ・ストリームmaxLobSizeおよびmaxRecordSizeを適切に設定します。 |
| 取引のグループ化 | xid、opSeqnoおよびtransIndを含めます。フィルタリングによってトランザクションから操作が削除される可能性があることを理解してください。 |
| ソース・レベルのコミット識別子 | csnを含めます。その値をソース依存の文字列として扱います。 |