パラメーター設定を使用すると、Notebook または SQL クエリの SQL コード内のパラメーター変数に値を割り当てることができます。SQL コードが実行されると、パラメーター変数は割り当てられた値に自動的に置き換えられます。このトピックでは、パラメーターの設定方法について説明します。
手順
以下の手順では、SQL クエリを例として使用します。パラメーターの設定手順は、Notebook ノードと SQL クエリノードの両方で同じです。
Dataphin のホームページのトップメニューバーで、[分析] > [SQL クエリ] または [Notebook] を選択します。
SQL クエリリストで、対象のタスクを選択し、編集エリアの上部にある
アイコンをクリックして、[パラメーター設定] ダイアログボックスを開きます。プロパティパネルで、[パラメーター設定] ダイアログボックスでタスクのパラメーターを設定します。
フィールド
説明
データソースモード
SQL クエリはデータソースモードの設定をサポートしています。データソースが Dev-Prod モードの場合、[開発] または [本番] を選択できます。データソースが Basic モードの場合、[本番] のみがサポートされます。
重要[本番] を選択すると、文の実行により本番環境のデータが変更されます。ご注意ください。
パラメーター名
パラメーター名は、SQL コードで定義された変数名です。SQL で式を使用して新しいパラメーターを追加します。システムは SQL コードから既存のパラメーターを自動的に読み込みます。式のフォーマット:
${variable_name}。パラメータータイプ
[パラメータータイプ] ドロップダウンリストをクリックして、パラメータータイプを変更します。 タイプには [グローバル変数]、[名前空間変数]、[ローカル変数]、[クロスノード変数]、および [非変数タイプ] があります。 詳細については、「パラメーター名」をご参照ください。
複数のパラメーターを選択するか、[すべて] を選択します。 次に、パラメーターリストの下部にある [パラメータータイプの変更] をクリックして、タイプを一括で変更します。
説明データセキュリティのため、アカウント・パスワードタイプのグローバル変数はここでは使用できません。これらはローカル変数として扱われ、手動で値を割り当てる必要があります。
権限管理が有効になっているグローバル変数を参照すると、システムは現在のユーザーに権限があるかどうかを自動的にチェックします。権限のないグローバル変数は、
アイコンでマークされます。[権限のリクエスト] をクリックして [権限管理] > [変数権限管理] ページに移動し、権限をリクエストします。ワークスペース名変数は分析プラットフォームではサポートされていません。
variable_nameが本番プロジェクトまたは本番セクションの名前と一致する場合、ローカル変数として扱われます。
パラメーター値
パラメーター変数を置き換える値を入力します。最大長は 256 文字です。空の値もサポートされています。日付と時刻の値に対して計算を実行することもできます。詳細については、「変数の割り当て」をご参照ください。
アクション
操作には、ローカル変数への変換と無視が含まれます。
ローカル変数に変換: 設定中の変数がグローバル変数と同じ名前の場合、システムはデフォルトでその変数をグローバル変数へのリファレンスとして扱います。パラメーターの [アクション] 列にある
アイコンをクリックすると、そのタイプをローカル変数に変換したり、ローカル変数をグローバル変数に変換したりできます。無視: コード内の
${variable_name}が変数ではなくコード内容の一部である場合は、対応するパラメーターの [アクション] 列にある
アイコンをクリックして、その変数を無視できます。
[OK] をクリックします。
重要単一の SQL ステートメントを実行する場合、未設定のパラメーターを設定するだけで済みます。設定された値は、ノード内でグローバルに有効になります。