クエリの文法

データテーブルに対するクエリは、Google BigQueryの標準SQL形式で記述します。

詳細については、Google BigQueryの標準SQLリファレンスを参照してください。

なお、 CREATE TABLE や INSERT INTO などデータ定義やデータ操作を行うSQLを直接実行することはできません。

パターン

SELECT
  user_id
  , age
FROM
  `project_id.dataset_id.table_id`

  <th>
    説明
  </th>
</tr>

  <td>
    プロジェクトID  
    ※ "prd-karte-per-client" になります。
  </td>
</tr>

<tr>
  <td>
    dataset_id
  </td>

  <td>
    データセット作成時につけた「データセット名」の末尾に、"_"  と「プロジェクトのAPIキー」を付与したもの
  </td>
</tr>

<tr>
  <td>
    table_id
  </td>

  <td>
    データテーブル作成時につけたテーブル名
  </td>
</tr>

例

SELECT
  user_id
  , age
FROM
  `prd-karte-per-client.karte_client_1234567890ab1234567890ab12345678.test_table`

ショートカットキー

• クエリ実行時には以下のショートカットも利用可能です。

  <th>
    ショートカットキー
  </th>
</tr>

  <td>
    Win：Ctrl-Enter  
    Mac：Command-Enter
  </td>
</tr>

<tr>
  <td>
    クエリの整形
  </td>

  <td>
    Win：Ctrl-Shift-F  
    Mac：Ctrl-Shift-F
  </td>
</tr>

ご注意ください

🚧 クエリの実行結果について

クエリ画面で実行した結果は999件まで確認することができます。

補足

📘 karte_event_*テーブルをクエリから参照する特殊な記法

karte_event_*テーブルをFROM句に指定する場合、通常のBigQueryのテーブル指定とは異なり、KARTEが定義する特殊な記法を使用する必要があります。

詳しくは以下をご覧下さい。
https://developers.karte.io/v1.0/docs/datahub-karte_event-table

※ クエリv1は、2025年2月までのご契約プロジェクトで利用可能です。2025年3月以降のご契約については、クエリv2のみの提供となります。

記述例（クエリv1）

 SELECT
   user_id
 FROM
   {{ karte_event('20180101', '20180131') }}

記述例（クエリv2）

 SELECT
   user_id
 FROM
   {% karte_event '20180101', '20180131' %}

補足

📘 UDFの利用について

一時的なSQL UDFのみご利用いただけます。
（永続的なSQL UDFや、JavaScript UDFはご利用頂けません）
（Datahubを活用してターゲット配信を行うのクエリ内では一時的なSQL UDFもご利用頂けません）

UDFの詳細については、Google BigQueryの標準 SQL ユーザー定義関数を参照してください