DataWorks:Oracle

背景情報

Oracle は、データを格納および処理するために使用されるリレーショナルデータベース管理システム (RDBMS) です。信頼性が高く、効率的で、安全なデータ管理および分析サービスを提供します。詳細については、「Oracle」をご参照ください。

前提条件

• ビジネスプロセスを作成します。

  DataStudio では、開発がビジネスプロセス単位で整理されます。ノードを作成する前に、必ずビジネスプロセスを作成してください。詳細については、「ワークフローの作成」をご参照ください。

• Oracle データソースが作成されました。

  データベースからデータにアクセスするには、事前に Oracle データベースを DataWorks のデータソースとして登録する必要があります。詳細については、「Oracle データソース」をご参照ください。

  説明

  Oracle ノードは、JDBC 接続文字列を使用して作成された Oracle データソースのみをサポートします。

• （任意：RAM ユーザーの場合必須）RAM ユーザーをワークスペースに追加し、開発者 または ワークスペース管理者 のロールを割り当てます。ワークスペース管理者ロールは権限が高いため、付与には十分な注意が必要です。詳細については、「ワークスペースへのメンバー追加」をご参照ください。

制限事項

対応リージョン：中国 (杭州)、中国 (上海)、中国 (北京)、、中国 (深セン)、中国 (成都)、中国 (香港)、シンガポール、マレーシア (クアラルンプール)、ドイツ (フランクフルト)、米国 (シリコンバレー)、米国 (バージニア)。

ステップ 1：Oracle ノードの作成

1. DataStudio ページに移動します。

   DataWorks コンソール にログインします。上部ナビゲーションバーから対象のリージョンを選択します。左側ナビゲーションウィンドウで、データ開発および運用管理 > データ開発 を選択します。表示されたページで、ドロップダウンリストから対象のワークスペースを選択し、データ開発へ移動 をクリックします。

2. 対象のビジネスプロセスを右クリックし、ノードの作成 > データベース > Oracle を選択します。

3. ノードの作成 ダイアログボックスで、ノードの 名前 を入力し、確認 をクリックします。ノードが作成された後、その構成タブでタスクの開発および設定を行います。

ステップ 2：Oracle タスクの開発

（任意）Oracle データソースの選択

ワークスペース内に複数の Oracle データソースが作成されている場合、Oracle ノードの構成タブでまずデータソースを選択する必要があります。Oracle データソースが 1 つのみ作成されている場合は、デフォルトでそのデータソースが使用されます。

SQL コードの開発：シンプルな例

Oracle ノードのコードエディタにタスクのコードを記述します。以下の例では、現在のユーザーがアクセス可能なすべてのテーブルの基本情報をクエリする方法を示しています。

SELECT * FROM ALL_TABLES;

SQL コードの開発：スケジューリングパラメーターの使用

DataWorks では、繰り返し実行されるスケジュール実行シナリオにおいて動的リクエストパラメーターを利用するための スケジューリングパラメーター を提供しています。ノードタスクのコード内で、${variable_name} の形式で変数を定義できます。その後、ノード構成タブの右側ナビゲーションペインにある スケジュール > スケジューリングパラメーター セクションで、変数に値を割り当てます。サポートされるスケジューリングパラメーターのフォーマットおよび設定方法については、「スケジューリングパラメーターのサポートフォーマット」および「スケジューリングパラメーターの設定と使用」をご参照ください。

例：「先月から現在までの期間に作成されたテーブルの所有者、名前、作成日時をクエリする」。スケジューリングパラメーター a には $[add_months(yyyymm,-1)] を設定し、これは前月を表します。

コードは以下のとおりです。

SELECT owner, object_name, created
FROM all_objects
WHERE object_type = 'TABLE' AND created >= TO_TIMESTAMP('${a}', 'YYYY-MM-DD');

ステップ 3：タスクのスケジュール設定

タスクをスケジュールするには、右側の スケジュール設定 をクリックし、各種プロパティを設定します。詳細については、「概要」をご参照ください。

ステップ 4：タスクのデバッグ コード

タスクを正しく実行できることを確認するためにデバッグを行います。

1. （任意）デバッグ用リソースグループを選択し、パラメーター値を割り当てます。

   • ツールバーの アイコンをクリックします。パラメーター ダイアログボックスで、リソースグループを選択します。

   • デバッグ用にスケジューリングパラメーターの値を割り当てます。パラメーター割り当てのロジックについては、「タスクデバッグの手順」をご参照ください。

2. タスクコードを保存して実行します。

   アイコンをクリックして保存し、その後 アイコンをクリックして実行します。

3. （任意）スモークテストを実行します。

   提出中または提出後にスモークテストを実行し、開発環境での実行を検証します。詳細については、「スモークテストの実施」をご参照ください。

ステップ 5：タスクの提出および公開

ノードを提出および公開することで、スケジュールを有効化します。

1. ツールバーの アイコンをクリックしてノードを保存します。

2. ツールバーの アイコンをクリックしてノードタスクを提出します。

   提出 ダイアログボックスで、変更内容の説明 を入力し、コードレビューのオプションを選択します。

   説明

   • 提出前に、再実行プロパティ および 上流依存ノード を設定してください。

   • コードレビューは品質保証のための機能です。有効化した場合、公開前にレビュアーによる承認が必要になります。詳細については、「コードレビュー」をご参照ください。

標準モードのワークスペースでは、右上隅の 公開 をクリックして本番環境にデプロイします。詳細については、「タスクの公開」をご参照ください。

次のステップ

タスクが提出および公開されると、ノードの設定に基づいて定期的に実行されます。ノード構成タブの右上隅にある 運用管理 をクリックすると、オペレーションセンターに移動できます。オペレーションセンターでは、定期タスクのスケジュール状態および実行状態を確認できます。詳細については、「定期タスクの管理」をご参照ください。