DataWorks の SQL Server ノードを使用して、SQL Server タスクを開発し、定期実行のスケジュールを構成し、他の操作と統合します。本トピックでは、タスク開発の手順について説明します。
背景情報
SQL Server は、データの保存および処理に使用されるリレーショナルデータベース管理システム(RDBMS)です。信頼性、効率性、およびセキュリティを備えたデータ管理サービスを提供します。詳細については、「SQL Server」をご参照ください。
前提条件
ビジネスフローを作成します。
DataStudio では、開発がビジネスフロー単位で整理されます。ノードを作成する前に、必ずビジネスフローを作成してください。詳細については、「ワークフローの作成」をご参照ください。
SQL Server データソースを [JDBC 接続文字列] モードで作成しました。詳細については、「データソース管理」をご参照ください。
(任意:RAM ユーザーの場合のみ必須)RAM ユーザーをワークスペースに追加し、開発者 または ワークスペース管理者 のロールを割り当てます。ワークスペース管理者ロールは権限が高いため、付与には十分な注意が必要です。詳細については、「ワークスペースへのメンバー追加」をご参照ください。
制限事項
対応リージョン:中国 (杭州)、中国 (上海)、中国 (北京)、中国 (深セン)、中国 (成都)、中国 (香港)、シンガポール、マレーシア (クアラルンプール)、ドイツ (フランクフルト)、米国 (シリコンバレー)、米国 (バージニア)。
ストアドプロシージャはサポートされていません。
ステップ 1:SQL Server ノードの作成
DataStudio ページに移動します。
DataWorks コンソール にログインします。上部ナビゲーションバーから対象のリージョンを選択します。左側ナビゲーションウィンドウで、 を選択します。表示されたページで、ドロップダウンリストから対象のワークスペースを選択し、データ開発へ移動 をクリックします。
対象のワークフローを右クリックし、 を選択します。
ノードの作成 ダイアログボックスで、ノードの 名前 を入力し、確認 をクリックします。
ステップ 2:SQL Server タスクの開発
(任意)SQL Server データソースの選択
ワークスペースに複数の SQL Server データソースが存在する場合、ノードの構成タブで対象のデータソースを選択します。データソースが 1 つのみの場合は、デフォルトでそのデータソースが選択されます。
SQL Server ノードは、JDBC 接続文字列モードで作成された SQL Server データソースのみをサポートします。
SQL コードの開発:シンプルな例
コードエディタにタスクコードを入力します。以下の例では、データベース内のすべてのユーザー定義テーブルの基本情報を照会しています:
SELECT * FROM sys.tables;SQL コードの開発:スケジューリングパラメーターの使用
DataWorks では、定期実行のシナリオにおいて、スケジューリングパラメーター を使用して値を動的に渡すことができます。コード内で ${変数名} の構文を使って変数を定義し、右側の プロパティ > スケジューリングパラメーター セクションで変数に値を割り当てます。フォーマットおよび構成方法の詳細については、「スケジューリングパラメーターの対応フォーマット」および「スケジューリングパラメーターの構成と使用」をご参照ください。
例:過去 1 年間に作成されたユーザー定義テーブルの名前と作成日時を照会する。スケジューリングパラメーター a の値は $[add_months(yyyymmdd,-12)] であり、1 年前の日付を表します。
サンプルコード:
SELECT name, create_date
FROM sys.tables
WHERE type = 'U' AND create_date >= '${a}';ステップ 3:タスクのスケジュール構成
タスクをスケジュールするには、右側の スケジュール構成 をクリックしてプロパティを構成します。詳細については、「概要」をご参照ください。
提出前に、再実行設定 および 上流依存ノード を構成してください。
ステップ 4:タスクコードのデバッグ
タスクをデバッグして、正しく実行されることを確認します:
(任意)デバッグ用リソースグループを選択し、パラメーター値を割り当てます。
ツールバーの
アイコンをクリックします。パラメーター ダイアログボックスで、リソースグループを選択します。デバッグ用のスケジューリングパラメーターに値を割り当てます。パラメーター割り当てのロジックについては、「タスクデバッグのプロセス」をご参照ください。
タスクコードを保存して実行します。
アイコンをクリックして保存し、その後
アイコンをクリックして実行します。(任意)スモークテストを実行します。
提出中または提出後にスモークテストを実行して、開発環境での実行を検証します。詳細については、「スモークテストの実施」をご参照ください。
ステップ 5:タスクの提出および公開
ノードを提出および公開して、スケジュールを有効化します。
ツールバーの
アイコンをクリックしてノードを保存します。ツールバーの
アイコンをクリックしてノードタスクを提出します。提出 ダイアログボックスで、変更内容の説明 を入力し、コードレビューのオプションを選択します。
説明提出前に、再実行設定 および 上流依存ノード を構成してください。
コードレビューは品質保証のための機能です。有効化すると、公開前にレビュアーによる承認が必要になります。詳細については、「コードレビュー」をご参照ください。
標準モードのワークスペースでは、右上隅の 公開 をクリックして本番環境へデプロイします。詳細については、「タスクの公開」をご参照ください。
次のステップ
タスクが提出および公開されると、ノードの構成に基づいて定期的に実行されます。ノード構成タブの右上隅にある 運用保守 をクリックして、オペレーションセンターに移動できます。オペレーションセンターでは、定期実行タスクのスケジュール状態および実行状態を確認できます。詳細については、「定期実行タスクの管理」をご参照ください。