SQLタスクの作成

• コンソール
• CLI
• API

• 1. タスクを作成するプロジェクトまたはフォルダを開きます。

     プロジェクトまたはフォルダの詳細ページを開くステップは、プロジェクトの詳細の表示またはフォルダの詳細の表示を参照してください。

  2. プロジェクトまたはフォルダの詳細ページで、「タスク」をクリックします。
  3. 「タスク」セクションで、「タスクの作成」をクリックし、「SQL」を選択します。
  4. 「SQLタスクの作成」ページで、名前とオプションの説明を入力します。

     識別子は、名前に基づいてシステムによって生成される値です。この値は変更できませんが、タスクを作成して保存した後は識別子を更新できません。

  5. このタスクの同時実行を禁止する場合は、「タスクの同時実行を無効化」チェック・ボックスを選択します。
  6. (オプション)「プロジェクトまたはフォルダ」で、「選択」をクリックし、タスクを保存する別のプロジェクトまたはフォルダを選択します。
  7. 最初にタスクを保存するには、次のいずれかのボタンをクリックします。

     • 作成: タスクを作成して保存します。タスクの作成と編集を続行できます。

     • 作成してクローズ: タスクを作成して保存し、ページを閉じ、プロジェクトまたはフォルダの詳細ページのタスク・リストに戻ります。

  8. 次のいずれかのボタンをクリックして、作業中に定期的に保存します。

     • 保存: 前回の保存以降の変更をコミットします。保存後に編集を続行できます。

     • 保存してクローズ: プロジェクトまたはフォルダの詳細ページのタスク・リストに戻り、変更をコミットします。

     • 別名保存: 現在のタスクを上書きせずに、変更内容(最後の保存以降)をコミットしてコピーに保存します。コピーの名前を指定し、コピーのために別のプロジェクトまたはフォルダを選択することも、コピーを既存のタスクと同じプロジェクトまたはフォルダに保存することもできます。

  9. 「SQL」セクションで、「選択」をクリックし、使用するストアド・プロシージャが保存されるデータベースに関連付けられているデータ・アセットを選択します。

     表示される「SQLの選択」ページで、タイプを直接選択するか、タイプが表示される順序でのみリソース・タイプをパラメータ化します。

     1. リソース・タイプを直接検索して選択するには、選択可能なタイプの横にある「選択」をクリックします。

        • データ・アセット: データ・アセットの名前。

        • 接続: データ・アセットに関連付けられているデータベースへのアクセスに使用する接続。

        • スキーマ: ストアド・プロシージャを所有するスキーマ。

        • ストアド・プロシージャ: このSQLタスクに使用するストアド・プロシージャの名前です。

          ストアド・プロシージャを選択する前に、そのプロシージャ内のパラメータを表示するには:

          1. 「ストアド・プロシージャの選択」パネルで、「すべて表示」をクリックします。
          2. 「ストアド・プロシージャの参照」パネルで、目的のストアド・プロシージャを見つけて、そのストアド・プロシージャの「アクション」メニュー()から「パラメータの表示」を選択します。
     2. リソース・タイプにパラメータを割り当てるには:

        1. リソース・タイプの横にある「パラメータの割当て」をクリックします。

        2. 「パラメータの割当て」ページで、次のいずれかを実行します。

           • リストからパラメータを選択します。同じリソース・タイプのパラメータのみが、選択のためにリストに表示されます。

           • 「パラメータの追加」をクリックして、リソース・タイプのパラメータを追加します。

             1. 「パラメータの追加」パネルで、識別子とオプションの説明を入力します。

             2. リソースタイプのパラメータのデフォルト値を設定します。

                ストアド・プロシージャ・タイプの場合、そのプロシージャを選択する前に、ストアド・プロシージャ内のパラメータを表示できます。「ストアド・プロシージャ」メニューの横にある「すべて表示」をクリックします。表示される「ストアド・プロシージャの参照」パネルで、目的のストアド・プロシージャを見つけて、そのストアド・プロシージャの「アクション」メニュー()から「パラメータの表示」を選択します。

             3. 「追加」をクリックします。

                追加されたリソース・タイプ・パラメータは、「パラメータの割当て」ページで自動的に選択されます。

        3. 「Assign」をクリックします。
     3. 「SQLの選択」ページで、「完了」をクリックします。

        「SQLタスクの作成」ページに戻ります。

  10. 「パラメータの構成」セクションで、「構成」をクリックしてパラメータのリストを確認し、その値を構成します。

      「構成されたパラメータ」の横に、ストアド・プロシージャのパラメータ数が表示されます。ストアド・プロシージャの入力パラメータ値のみを構成できます。

      入力パラメータに構成した値は、そのパラメータに定義されているデータ型と一致する必要があります。たとえば、データ型がNUMERICである入力パラメータにSTRING値を指定することはできません。

      「ストアド・プロシージャ・パラメータの構成」ページで、次のステップに従ってパラメータ値を構成します。

      1. 構成する入力パラメータ値の行で、「構成」をクリックします。
      2. 「パラメータの編集」パネルで、入力パラメータの値を入力し、「保存」をクリックします。

         入力パラメータを構成した後で、値を編集またはクリアできます。

      3. 入力パラメータの構成が終了したら、「構成」をクリックします。
  11. (オプション)「タスクの検証」セクションで、「検証」をクリックして、構成したパラメータ値を確認します。

      エラーまたは警告がある場合は、「メッセージの表示」をクリックします。エラーがあれば、タスクを公開する前に解決します。

      ノート
      
      NUMERICデータ型の入力パラメータに、構成されたデフォルト値としてNULLが含まれている場合、SQLタスクの実行に失敗しました。タスク実行の失敗を回避するには、NULL値を0 (0)に変更します。
  12. タスクの構成が終了したら、「作成して閉じる」または「保存して閉じる」をクリックします。

  SQLタスクをデータ統合のアプリケーションに公開した後で、タスクを実行するか、タスク実行をスケジュールします。情報の公開については、データ統合アプリケーションへの公開を参照してください。

• SQLタスクを作成するには、oci data-integration task create-task-from-SQL-taskコマンドと必要なパラメータを使用します:

  oci data-integration task create-task-from-sql-task [OPTIONS]

  CLIコマンドのフラグおよび変数オプションの完全なリストは、コマンドライン・リファレンスを参照してください。

• 適切なリソース・サブタイプを指定してCreateTask操作を実行し、SQLタスクを作成します。