Oracle データソースを作成することで、Dataphin が Oracle からビジネスデータを読み取ったり、Oracle へデータを書き込んだりできるようになります。本トピックでは、Oracle データソースの作成手順について説明します。
背景情報
Oracle は、移植性・信頼性・適応性・パワフルさを兼ね備えたリレーショナルデータベースです。Oracle を利用する場合、Dataphin とのデータ開発連携を行う前に、事前に Oracle データソースを作成する必要があります。
必要な権限
データソースを作成できるのは、カスタムグローバルロールで データソースの作成 権限が付与されたユーザー、または スーパー管理者、データソース管理者、ドメインアーキテクト、プロジェクト管理者 のいずれかのロールを持つユーザーのみです。
操作手順
Dataphin ホームページの上部ナビゲーションバーで、管理センター > データソース管理 を選択します。
データソース ページで、+データソースの作成 をクリックします。
データソースの作成 ページで、リレーショナルデータベース セクションより Oracle を選択します。
最近使用した Oracle データソースがある場合は、最近使用したデータソース セクションから Oracle を選択することもできます。また、検索ボックスに「Oracle」などのキーワードを入力して、素早く該当項目を検索することも可能です。
Oracle データソースの作成 ページで、接続パラメーターを設定します。
データソースの基本情報を設定します。
パラメーター
説明
データソース名
データソースの名前を入力します。以下の要件を満たす必要があります:
名前には、漢字、英字、数字、アンダースコア(_)、ハイフン(-)のみを使用できます。
最大長は 64 文字です。
データソースコード
データソースコードを設定すると、Flink_SQL タスクや Dataphin JDBC クライアントから、
Data source code.Table nameまたはData source code.schema.Table nameというフォーマットで Dataphin データソーステーブルにアクセスして、迅速に利用できます。タスク実行環境に基づいてデータソースを自動的に切り替えるには、${Data source code}.tableまたは${Data source code}.schema.tableの変数フォーマットでデータソースにアクセスできます。詳細については、「Dataphin データソーステーブルの開発メソッド」、「」をご参照ください。重要データソースコードは設定後、変更できません。
データソースコードを設定した後に、資産ディレクトリおよび資産チェックリストのオブジェクト詳細ページでデータのプレビューが可能になります。
Flink SQL では、現時点で MySQL、Hologres、MaxCompute、Oracle、StarRocks、Hive、SelectDB、GaussDB データウェアハウスサービス(DWS)のデータソースのみがサポートされています。
バージョン
作成する Oracle データソースのバージョンを選択します。対応バージョンは、Oracle11g、Oracle12c、Oracle18c、Oracle19c、Oracle21c、Oracle23c です。
データソースの説明
データソースの簡単な説明を入力します。説明は 128 文字以内である必要があります。
タイムゾーン
統合タスクにおける時刻形式データの処理に使用されます。デフォルトのタイムゾーンは Asia/Shanghai です。変更 をクリックして、目的のタイムゾーンを選択してください。選択可能なオプションは以下のとおりです:
GMT: GMT-12:00、GMT-11:00、GMT-10:00、GMT-09:30、GMT-09:00、GMT-08:00、GMT-07:00、GMT-06:00、GMT-05:00、GMT-04:00、GMT-03:00、GMT-03:00、GMT-02:30、GMT-02:00、GMT-01:00、GMT+00:00、GMT+01:00、GMT+02:00、GMT+03:00、GMT+03:30、GMT+04:00、GMT+04:30、GMT+05:00、GMT+05:30、GMT+05:45、GMT+06:00、GMT+06:30、GMT+07:00、GMT+08:00、GMT+08:45、GMT+09:00、GMT+09:30、GMT+10:00、GMT+10:30、GMT+11:00、GMT+12:00、GMT+12:45、GMT+13:00、GMT+14:00。
夏時間(Daylight Saving Time): Africa/Cairo、America/Chicago、America/Denver、America/Los_Angeles、America/New_York、America/Sao_Paulo、Asia/Bangkok、Asia/Dubai、Asia/Kolkata、Asia/Shanghai、Asia/Tokyo、Atlantic/Azores、Australia/Sydney、Europe/Berlin、Europe/London、Europe/Moscow、Europe/Paris、Pacific/Auckland、Pacific/Honolulu。
データソース構成
構成するデータソースを選択します:
業務データソースで本番環境と開発環境を区別している場合は、本番+開発データソース を選択します。
業務データソースで本番環境と開発環境を区別していない場合は、本番データソース を選択します。
タグ
タグを用いてデータソースを分類・管理できます。タグの作成方法については、「データソースタグの管理」「」をご参照ください。
データソースと Dataphin 間の接続パラメーターを設定します。
データソース構成として 本番+開発データソース を選択した場合、本番+開発データソース の接続情報を設定する必要があります。一方、データソース構成が 本番データソース の場合は、本番データソース の接続情報のみを設定すればよいです。
説明通常、開発環境と本番環境を分離し、開発データソースによる本番データソースへの影響を最小限に抑えるため、本番データソースと開発データソースは異なるデータソースとして個別に構成することを推奨します。ただし、Dataphin では、両者を同一のデータソースとして、同一のパラメーター値で構成することもサポートしています。
構成方法 として、JDBC URL または ホスト を選択できます。デフォルトは JDBC URL です。
JDBC URL 構成方法
パラメーター
説明
JDBC URL
接続アドレスの形式は、
jdbc:oracle:thin:@host:port:sidまたはjdbc:oracle:thin:@//host:port/servicenameです。スキーマ
Oracle インスタンス内のデータベース名です。
ユーザー名、パスワード
Oracle インスタンスにログインする際に使用するユーザー名とパスワードです。
ホスト構成方法
ホスト構成方法
パラメーター
説明
サービスタイプ
サービス名、SID(System Identifier)、または ロードバランシング を選択できます。
サーバーアドレス
サーバーの IP アドレスとポート番号を入力します。
サービスタイプを ロードバランシング に選択した場合のみ、複数の IP アドレスとポート番号の組み合わせをサポートします。追加 をクリックして新しい行を追加してください。
dbname
データベース名を入力します。
パラメーター構成
パラメーター
説明
パラメーター
パラメーター名: 既存のパラメーター名を選択するか、カスタムパラメーター名を入力できます。
カスタムパラメーター名には、大文字と小文字、数字、ピリオド (.)、アンダースコア (_)、およびハイフン (-) のみを含めることができます。
パラメーター値: パラメーター名を選択した場合、パラメーター値の入力は必須です。値には、大文字・小文字の英字、数字、ピリオド(.)、アンダースコア(_)、ハイフン(-)のみ使用でき、最大 256 文字までです。
説明+パラメーターの追加 をクリックして複数のパラメーターを追加でき、
アイコンをクリックして不要なパラメーターを削除できます。最大で 30 個のパラメーターを追加できます。スキーマ(任意)
リアルタイムデータベース移行のみを目的とする場合は、スキーマを入力する必要はありません。オフライン統合またはリアルタイムコンピューティングを目的とする場合は、スキーマを入力する必要があります(スキーマ情報は大文字・小文字を区別します)。
ユーザー名、パスワード
Oracle インスタンスにログインする際に使用するユーザー名とパスワードです。
説明構成方法を「ホスト」に設定し、データソースの作成が完了した後、JDBC URL 構成方法に切り替える場合、システムはサーバーの IP アドレスとポート番号を連結して JDBC URL を生成し、その値を自動的に設定します。
データソースと Dataphin 間の接続に関する高度な設定を構成します。
パラメーター
説明
接続リトライ回数
データベース接続がタイムアウトした場合、システムは指定されたリトライ回数に達するまで自動的に再接続を試行します。最大リトライ回数に達しても接続が成功しない場合、接続は失敗します。
説明デフォルトのリトライ回数は 1 回であり、0~10 の範囲で設定できます。
接続リトライ回数は、デフォルトで オフライン統合タスク および グローバル品質(資産品質機能モジュールが有効化されている場合)に適用されます。オフライン統合タスクでは、タスク単位でリトライ回数を個別に設定することも可能です。
説明重複するパラメーターのルール:
パラメーターが JDBC URL、高度な設定、および ホスト構成 のいずれにも存在する場合、JDBC URL 内の値が優先されます。
パラメーターが JDBC URL および 高度な設定 の両方に存在する場合、JDBC URL 内の値が優先されます。
パラメーターが 高度な設定 および ホスト構成 の両方に存在する場合、高度な設定 内の値が優先されます。
デフォルトリソースグループ を選択します。このリソースグループは、現在のデータソースに関連するタスク(データベース SQL 実行、オフラインデータベース移行、データプレビューなど)の実行に使用されます。
接続テスト を実行するか、または直接 OK をクリックして、Oracle データソースの作成を保存・完了します。
接続テスト をクリックすると、データソースが Dataphin に正常に接続できるかをシステムがテストします。直接 OK をクリックした場合、システムは選択されたすべてのクラスターに対して自動的に接続テストを実行しますが、すべての選択クラスターが接続に失敗した場合でも、データソースの作成自体は正常に完了します。
接続テスト は、デフォルトクラスター または Dataphin に登録済みかつ正常に稼働中の 登録済みスケジューリングクラスター に対して実行されます。デフォルトクラスター がデフォルトで選択され、解除することはできません。登録済みスケジューリングクラスターにリソースグループが未作成の場合、接続テストはサポートされません。接続テストを実行するには、まずリソースグループを作成してください。
選択されたクラスターは、現在のデータソースとのネットワーク接続性をテストする目的でのみ使用され、今後の関連タスク実行には使用されません。
接続テストは通常 2 分以内に完了します。タイムアウトした場合は、
アイコンをクリックして具体的な原因を確認し、再試行できます。テスト結果が 接続失敗、接続成功、または 警告あり接続成功 のいずれであっても、最終結果の生成時刻が記録されます。
説明デフォルトクラスター のテスト結果のみが、警告あり接続成功、接続成功、接続失敗 の 3 種類のステータスを含みます。登録済みスケジューリングクラスター のテスト結果は、接続成功 および 接続失敗 の 2 種類のみです。
テスト結果が 接続失敗 の場合、
アイコンをクリックして具体的な失敗原因を確認できます。テスト結果が 警告あり接続成功 の場合、アプリケーションクラスターへの接続は成功しましたが、スケジューリングクラスターへの接続に失敗しています。この状態では、現在のデータソースをデータ開発および統合に使用できません。
アイコンをクリックしてログ情報を確認できます。