すべてのプロダクト
Search
ドキュメントセンター

Dataphin:パラメーター設定

最終更新日:Jan 20, 2026

パラメーター設定を使用すると、Notebook または SQL クエリの SQL コード内のパラメーター変数に値を割り当てることができます。SQL コードが実行されると、パラメーター変数は割り当てられた値に自動的に置き換えられます。このトピックでは、パラメーターの設定方法について説明します。

手順

以下の手順では、SQL クエリを例として使用します。パラメーターの設定手順は、Notebook ノードと SQL クエリノードの両方で同じです。

  1. Dataphin のホームページのトップメニューバーで、[分析] > [SQL クエリ] または [Notebook] を選択します。

  2. SQL クエリリストで、対象のタスクを選択し、編集エリアの上部にある image..png アイコンをクリックして、[パラメーター設定] ダイアログボックスを開きます。

  3. プロパティパネルで、[パラメーター設定] ダイアログボックスでタスクのパラメーターを設定します。

    フィールド

    説明

    データソースモード

    SQL クエリはデータソースモードの設定をサポートしています。データソースが Dev-Prod モードの場合、[開発] または [本番] を選択できます。データソースが Basic モードの場合、[本番] のみがサポートされます。

    重要

    [本番] を選択すると、文の実行により本番環境のデータが変更されます。ご注意ください。

    パラメーター名

    パラメーター名は、SQL コードで定義された変数名です。SQL で式を使用して新しいパラメーターを追加します。システムは SQL コードから既存のパラメーターを自動的に読み込みます。式のフォーマット${variable_name}

    パラメータータイプ

    [パラメータータイプ] ドロップダウンリストをクリックして、パラメータータイプを変更します。 タイプには [グローバル変数][名前空間変数][ローカル変数][クロスノード変数]、および [非変数タイプ] があります 詳細については、「パラメーター名」をご参照ください。

    複数のパラメーターを選択するか、[すべて] を選択します。 次に、パラメーターリストの下部にある [パラメータータイプの変更] をクリックして、タイプを一括で変更します。

    説明
    • データセキュリティのため、アカウント・パスワードタイプのグローバル変数はここでは使用できません。これらはローカル変数として扱われ、手動で値を割り当てる必要があります。

    • 権限管理が有効になっているグローバル変数を参照すると、システムは現在のユーザーに権限があるかどうかを自動的にチェックします。権限のないグローバル変数は、image アイコンでマークされます。[権限のリクエスト] をクリックして [権限管理] > [変数権限管理] ページに移動し、権限をリクエストします。

    • ワークスペース名変数は分析プラットフォームではサポートされていません。variable_name が本番プロジェクトまたは本番セクションの名前と一致する場合、ローカル変数として扱われます。

    パラメーター値

    パラメーター変数を置き換える値を入力します。最大長は 256 文字です。空の値もサポートされています。日付と時刻の値に対して計算を実行することもできます。詳細については、「変数の割り当て」をご参照ください。

    アクション

    操作には、ローカル変数への変換と無視が含まれます。

    • ローカル変数に変換: 設定中の変数がグローバル変数と同じ名前の場合、システムはデフォルトでその変数をグローバル変数へのリファレンスとして扱います。パラメーターの [アクション] 列にある image アイコンをクリックすると、そのタイプをローカル変数に変換したり、ローカル変数をグローバル変数に変換したりできます。

    • 無視: コード内の ${variable_name} が変数ではなくコード内容の一部である場合は、対応するパラメーターの [アクション] 列にある image アイコンをクリックして、その変数を無視できます。

  4. [OK] をクリックします。

    重要

    単一の SQL ステートメントを実行する場合、未設定のパラメーターを設定するだけで済みます。設定された値は、ノード内でグローバルに有効になります。