パラメータ化されたクエリの記述
SQL ステートメントでセルを参照することで、動的スプレッドシートを作成できます。本製品 は、ステートメントをパラメータ化されたクエリとして実行します。シート内の値を変更すると、本製品 は新しいクエリを実行します。
検索可能なスプレッドシートの作成
パラメータ化されたSELECT WHERE クエリを使用して、セルを編集するときにデータを動的にフィルタするスプレッドシートを作成します。次のフィルタ検索条件は@InputSheet!A2 パラメータ(InputSheet シートのセルA2)を参照します。
SELECT Snippet_Title, ContentDetails_ItemType FROM Groups WHERE Id = @InputSheet!A2
任意パラメータと必須パラメータの定義
パラメータに@@ を付ける場合、参照セルの空の値はクエリに影響しません(すなわち、空の値のセルが参照されるコンディションは削除されます)。
次のクエリでは、ContentDetails_ItemType はオプションの検索パラメータですが、Id が指定される必要があります。
SELECT * FROM Groups WHERE Id = @InputSheet!A2 AND ContentDetails_ItemType = @@InputSheet!A3
動的なテーブル参照
セル参照の前に@@@を付けることで、クエリ内のテーブルを動的に参照できます。次のクエリは、InputSheet シートのセルA1 から値を読み取り、リクエストを実行する際にテーブル名に使用します。
SELECT * FROM @@@InputSheet!A1
その他の検索条件の記述
デフォルトでは、YouTube Analytics カラムがセル値を持つ場合には、本製品 は一致を報告します。例えば、参照されたセルの値が'S' である場合、同等のSQL 述語は:
LIKE '%S%'
セル値に'%' を追加することで、start-with およびends-with 検索を実行することができます。
InputSheet!A2 Cell | Query | Equivalent Predicate |
'S' | SELECT * FROM Groups WHERE Id LIKE @InputSheet!A2 | LIKE '%S%' |
'%S' | SELECT * FROM Groups WHERE Id LIKE @InputSheet!A2 | LIKE '%S' |
'S%' | SELECT * FROM Groups WHERE Id LIKE @InputSheet!A2 | LIKE 'S%' |