変数利用方法(分析プロジェクト)
分析プロジェクトのどこに変数を書けるか、どう書くかを説明します。使えるのは、その分析プロジェクトのローカル変数と、そこにインポートした共通変数です。
処理設定で使う
自由に文字を入力できる欄で使えます。欄をクリックすると、使える変数が候補として出るので、選ぶと $変数名 の形で入ります。候補から選ばずに、直接 $変数名 と打っても同じです。
候補は見出しで分かれています。 変数は「変数から選ぶ」の下に並びます。欄によっては「入力した値」「候補から選ぶ」「列の値から選ぶ」も一緒に出ます。多いときは群ごとに先頭だけが出て、残りは「他 N 件を表示」で開きます。
SQLビルダーのクエリで使う
SQLビルダーでも同じ変数が使えます。ただしクエリでは、文の中に混ぜて書けます。 WHERE date >= '$start_date' のように書けば、実行時にその部分だけが値に置き換わります。${start_date} と波かっこで囲む書き方もできます。
データ出力先で使う
下記の出力先と欄で、変数が値に置き換わります。
| 出力先 | 変数を書ける欄 |
|---|---|
| Google BigQuery | 対象のテーブル名（データセット名は一覧から選ぶ欄なので変数を入れられません） |
| MySQL | 対象のテーブル名 |
| SQL Server/Azure T-SQL | 対象のテーブル名 |
| Treasure Data | 対象のテーブル名 |
| Google スプレッドシート | シート名 |
| Amazon S3 | バケット名、ファイル名 |
| Google Cloud Storage | バケット名、ファイル名 |
| OneDrive | フォルダ URL、ファイル名 |
| SFTP | ファイル名 |
| このパソコンへの csv ダウンロード | ファイル名 |
出力先では、1 つの欄に複数の変数を書けます。 そのときは変数名を {} で囲んでください。filename と today の 2 つを使って Amazon S3 のファイル名を決めるなら、${filename}_${today}.csv と書きます。
変数が見つからないとき
書いた名前の変数がそのオブジェクトにないと、実行が止まります。
変数: todayが設定されていないため処理を中断しました。
直し方 — 名前の打ち間違いを直すか、その名前の変数を作ります。共通変数を使っているつもりなら、そのオブジェクトにインポートされているかを確かめてください。共通変数は、共通変数のインポートをして初めてそのオブジェクトで使えます。