データ変換を編集する

ファイルの表示と編集

SQL ファイルと入力ファイルがタブに表示されます。SQL ファイルまたは入力ファイルを開くと、データ変換エディターで新しいタブが開きます。これにより、複数のファイルを同時に開いて操作することができます。SQL ファイルに未保存の変更がある場合は、タブに青い点で示されます。ピン留めされたタブでファイルを開くと、ファイルを繰り返し開き直さなくてもすばやくアクセスできます。ファイルをピン留めすると、他のファイルを開いてもエディターに表示されたままになります。ファイルをダブルクリックするか、タブのコンテキスト メニューから [ ピン留め ] を選択してタブをピン留めできます。

注:

現在開いている SQL ファイルに未保存の変更がある場合、新しいファイルを開いたときにそれらの変更が独自のタブに残ります。未保存の変更がない場合、現在表示されているタブで新しい SQL ファイルが開きます。

ファイルを閉じる

タブのコンテキストメニューから、現在のタブ、すべてのタブ、または他のすべてのタブをすばやく閉じることができます。

タブ名を右クリックして、タブのコンテキスト メニューを開きます。

クエリを実行する

注:

[すべてのテストを実行] と [ファイルを実行 ] は 1 時間に制限されています。したがって、データ変換の開発とテストには小さいデータセットを使用し、変換がこの制限時間を超えないようにすることを強くお勧めします。詳しくは、「 Process Mining ポータル 」をご覧ください。

変換を編集しているときに [ すべて実行 ] を選択すると、その変更をテストして結果をプレビューできます。変更されたクエリと、関連するすべてのクエリを実行します。たとえば、 cases_input.sql が変更された場合などです。[すべて実行] コマンドでは、cases_input.sql が実行され、cases_input.sqlの結果を使用する cases.sqlが実行されます。

結果のデータは、ダッシュボード エディターではなく、データ変換エディターでのみ使用できます。

実行には次の 2 種類があります。

• [すべてを実行]: データ実行を開始し、変更されたすべてのクエリとその依存関係を再計算します。
• ファイルを実行: 実行を開始して、現在選択中の SQL ファイルとその親クエリのみを再計算します。このオプションでは、特定の SQL ファイルに対するカスタマイズをテストおよびデバッグできます。
  ヒント:

  いつでも [実行をキャンセル] を選択して変換の実行をキャンセルできます。

結果は [プレビュー] パネルに表示されます。

注:

[すべてを実行] は、パブリッシュ済みのプロセス アプリのデータには影響しません。

コンパイル済み SQL の表示

[ コンパイル済み SQL ] トグル オプションを有効化すると、クエリの実行後にコンパイル済みバージョンの SQL コードを表示できます。報告される行番号はコンパイルされた SQL の行番号に対応するため、SQL エラーをデバッグする場合に便利です。

注:

実行したばかりの SQL ファイルのみが [コンパイル済み SQL ] トグルを表示します。

フォルダーとファイルを追加する

変換内で新しいフォルダーを作成したり、新しいファイルを追加したりできます。

命名規則

• ファイル、フォルダー、フィールド、およびテーブルの名前の場合:
  • 小文字 (a-z)、大文字 (A-Z)、および数字 (0-9) のみを使用できます。
  • ファイル、フォルダー、フィールド、およびテーブルの名前に特殊文字 |*:?"<>\/ は使用できません。
• ファイル名に使用できる特殊文字は、_:. のみです。
• ファイル名の先頭に _ (アンダースコア) は使用できません。

変換のメニューから新しいフォルダーまたはファイルを作成する

次の手順に従って、新しいフォルダーまたはファイルを作成します。

手順	操作
1	変換内で、新しいファイルまたはフォルダーを追加する場所に移動します。
2	[変換] パネルに移動し、メニュー アイコン を選択して変換メニューを開きます。
3	メニューから該当するオプションを選択します。
4	新しいフォルダーまたはファイルのわかりやすい名前を入力し、Enter キーを押します。

選択したフォルダーに新しいフォルダーまたはファイルが作成されます。

コンテキスト メニューから新しいフォルダーまたはファイルを作成する

コンテキスト メニューから新しいフォルダーまたはファイルを作成するには、以下の手順に従います。

手順	操作
1	変換内で新しいファイルまたはフォルダーを追加するフォルダーの [ その他のアクション メニューを開きます。
2	メニューから該当するオプションを選択します。
3	新しいフォルダーまたはファイルのわかりやすい名前を入力し、Enter キーを押します。

選択したフォルダーに新しいフォルダーまたはファイルが作成されます。

ファイル内の未保存の変更

.sql ファイルを編集すると、[変換] フォルダー構造内に未保存の変更があることが青い点として表示されます。

ファイルの移動

ファイルは簡単にドラッグ アンド ドロップして、別のフォルダーに移動したり、フォルダー内で並べ替えたりできます。ファイルが誤って移動されることを防ぐための確認メッセージが表示されます。

フォルダーまたはファイルの名前を変更する

次の手順に従って、新しいフォルダーまたはファイルを作成します。

手順	操作
1	名前を変更するフォルダーまたはファイルの [ その他のアクション メニューを開いてコンテキスト メニューを開きます。
2	[名前を変更] を選択します。
3	必要に応じて名前を編集して Enter キーを押します。

フォルダーまたはファイルの名前が変更されます。

フォルダーまたはファイルを削除する

次の手順に従って、新しいフォルダーまたはファイルを作成します。

手順	操作
1	削除するフォルダーまたはファイルの [ その他のアクション メニューを開いてコンテキスト メニューを開きます。
2	[削除] を選択します。確認のメッセージが表示されます。
3	[削除] をクリックして削除を確定します。

フォルダーまたはファイルが削除されます。

ファイルを複製する

SQL ファイルを複製すると、完全に新しいファイルを作成することなく、クエリを再利用して変更を加えることができます。また、元のクエリを変更したり損傷したりすることなく、クエリに変更を加えるのにも役立ちます。

ファイルを複製すると、複製したファイルの直下の同じフォルダーに元のファイルのコピーが作成されます。

SQL ファイルを複製するには、以下の手順に従います。

手順	操作
1	複製するファイルの [その他のアクション メニューを開いてコンテキスト メニューを開きます。
2	[ 複製] を選択します。複製されたファイルは、元のファイルと同じ場所に挿入されます。

ファイルのコピー&ペースト

SQL ファイルをコピーして、別の場所に貼り付けることができます。SQL ファイルをコピーして貼り付けると、完全に新しいファイルを作成することなく、クエリを再利用したり、クエリを変更したりできます。

SQL ファイルをコピーして貼り付けるには、以下の手順に従います。

手順	操作
1	コピーするファイルの [ その他のアクション メニューを開いてメニューを開きます。
2	[ コピー] を選択します。
3	[その他のアクション] メニューを開きメニューから [貼り付け] を選択します。コピーしたファイルが挿入されます。
4	ファイルをドラッグ アンド ドロップして目的の場所に移動します。

ファイル内で検索/置換する

データ変換エディターでは、単一のファイル内でテキストを検索と置換できます。

テキストを検索

データ変換エディターでテキストを検索するには、次の手順に従います。

1. コード エディターでランダムな場所を選択するか、他の出現箇所を検索するテキストを選択します。
2. CTRL+F を押下します。
3. [Find] フィールドに検索するテキストを入力します。現在のファイル内に出現するすべてのテキストが強調表示されます。
4. ENTER キーを押すと、次の出現箇所にスキップします。

検索して置換

データ変換エディターでテキストを検索するには、次の手順に従います。

1. コード エディターでランダムな場所を選択するか、他の出現箇所を検索するテキストを選択します。
2. CTRL+H を押下します。
3. [Find] フィールドに検索したいテキストを入力し、[Replace] フィールドに新しいテキストを入力します。現在のファイル内に出現するすべてのテキストが強調表示されます。
4. ENTER キーを押してテキストを置換し、次の出現箇所にスキップします。

データ変換エディターでテキストを検索するには、次の手順に従います。

1. コード エディターを選択します。
2. CTRL+H を押下します。
3. [Find] フィールドに検索したいテキストを入力し、[Replace] フィールドに新しいテキストを入力します。現在のファイル内に出現するすべてのテキストが強調表示されます。
4. Crtl+Alt+Enter を押下します。
   ヒント:

   [Replace] または [Replace all] アイコンを使用することもできます。

複数のファイルで検索/置換を行う

複数のファイルでテキストを検索/置換するには外部エディターを使用します。

複数のファイルのテキストを検索/置換するには、以下の手順に従います。

1. プロセス アプリから変換をエクスポートします。
2. 変換の zip ファイルを解凍します。
3. 任意のコード エディター (Notepad++、または Visual Studio Code など) で変換を開きます。
4. それらのツールの機能を使用して、複数のファイルのテキストを検索/置換します。
5. ファイルを保存します。
6. 変換ファイルを .zip ファイルに追加します。
7. プロセス アプリに変換をインポートします。
   注:

   データ実行に使用するデータを尋ねられたら、新しいデータ実行の前に変換の編集を続行する場合は [キャンセル] を選択します。

ファイルにコメントを追加する

SQL 変換ファイルにコメントを含めたり、ファイルの一部をコメント アウトしたりする場合は、Jinja コメント構文の使用を強くお勧めします。これは、既定で {# ... #} に設定されています。これを使用してマクロにコメントを付けることもできます。

SQL

{# {{ pm_utils.optional(ref('Cases_base'), '"Case_status"') }} as "Case_status", #}

{# case
    when {{ pm_utils.optional(ref('Cases_base'), '"Case_value"', 'double') }} >= 1000000
      then {{ pm_utils.as_varchar('>= 1M') }}
    when {{ pm_utils.optional(ref('Cases_base'), '"Case_value"', 'double') }} >= 0
     then {{ pm_utils.as_varchar('0 - 1M') }}
   when {{ pm_utils.optional(ref('Cases_base'), '"Case_value"', 'double') }} is not null
     then {{ pm_utils.as_varchar('< 0') }}
  end as "Case_value_group", #}

dbt プロジェクト構成ファイルを編集する

データ変換エディターで dbt プロジェクトの構成ファイルを開くこともできます (例dbt_project.yml)。

警告:

必要に応じて、vars セクションのみを編集することを強くお勧めします。変換が正しく機能し続けるよう、dbt_project.yml の他の部分は変更しないでください。

dbt について詳しくは、dbt の公式ドキュメントをご覧ください。