Buat tabel

Tabel sementara dan tabel persisten membantu Anda menyederhanakan kueri, sehingga lebih mudah dipahami dan dikelola. Dengan membuat hasil perantara yang dapat Anda gunakan kembali, sekaligus memberi Anda opsi untuk menyimpan data sementara yang tidak diagregasi, Anda dapat mengurangi resource yang diperlukan untuk menjalankan kueri, sehingga meningkatkan performa.

Tabel yang dibuat tunduk pada pemeriksaan privasi statis, fungsi yang diizinkan, dan batasan gabungan kolom yang sama yang diterapkan di seluruh Ads Data Hub. Pemeriksaan privasi standar berlaku saat data dari pernyataan SELECT akhir ditampilkan ke BigQuery.

Untuk membuat tabel, ikuti sintaksis BigQuery:

CREATE [OR REPLACE] [TEMP | TEMPORARY] TABLE TABLE_NAME
 [OPTIONS(privacy_checked_export=<true | false>)] AS query_statement;

Klausul berikut tidak didukung:

• IF NOT EXISTS
• PARTITION BY
• CLUSTER BY

Tabel sementara

Tabel sementara (atau temp) meningkatkan keterbacaan kueri, dan memungkinkan Anda membuat hasil menengah yang dapat mencakup data yang tidak diagregasi.

Tabel sementara:

• Hanya ada di tingkat sesi, dan berakhir setelah eksekusi kueri
• Hanya dapat digunakan di dalam kueri tempat kueri tersebut dibuat
• Dapat menyimpan data yang belum digabungkan dan belum menerapkan pemeriksaan privasi
• Dirujuk berdasarkan nama tanpa namespace yang diperlukan

Untuk membuat tabel sementara, gunakan pernyataan CREATE TEMP TABLE. Contoh ini membuat tabel sementara untuk menyimpan hasil kueri, lalu menggunakan tabel sementara dalam subkueri:

-- Get a list of creative IDs and store in a temporary table called creative_list:
CREATE TEMP TABLE creative_list AS (
  SELECT
    adgroup_id,
    advertiser_id,
    creative_id
  FROM
    adh.dv360_youtube_impressions
);
-- Return creatives with a count of impressions greater than 100
SELECT
  creative_id,
  COUNT(*) AS imps
FROM
  creative_list
WHERE
  imps > 100
GROUP BY
  creative_id;

Tabel persisten

Jika perlu membuat tabel perantara untuk digunakan dalam kueri lain, Anda dapat membuat tabel persisten. Sintaksisnya sama seperti untuk tabel sementara, tanpa klausa TEMP. Tabel ini berlaku selama 72 jam. Jika tabel dengan nama yang dipilih sudah ada, tabel tersebut akan ditimpa.

Tabel persisten dapat menyimpan data yang tidak diagregasi, tetapi konten tabel tidak terlihat kecuali melalui hasil kueri yang diperiksa privasinya.

Tabel persisten:

• Berakhir setelah 72 jam
• Dapat digunakan di luar kueri yang membuatnya
• Dapat menyimpan data yang belum digabungkan dan belum menerapkan pemeriksaan privasi
• Direferensikan melalui namespace tmp, tetapi juga dapat direferensikan berdasarkan nama dalam kueri yang sama

Untuk membuat tabel persisten, gunakan pernyataan CREATE TABLE. Contoh ini membuat tabel persisten untuk menyimpan hasil kueri, lalu menggunakan tabel persisten dalam kueri berikutnya:

Kueri 1

-- Get a list of creative IDs and store in a persistent table called creative_list:
CREATE TABLE creative_list AS (
  SELECT
    adgroup_id,
    advertiser_id,
    creative_id
  FROM
    adh.dv360_youtube_impressions
);

-- Return the total count of impressions in the table
SELECT
  COUNT(*) AS imps
FROM
  tmp.creative_list -- Alternative: creative_list

Kueri 2

-- Return creatives which had more than 100 impressions
SELECT
  creative_id,
  COUNT(*) AS imps
FROM
  tmp.creative_list
WHERE
  imps > 100
GROUP BY
  creative_id;

Catatan: Saat Anda menjalankan kueri yang hanya terdiri dari pernyataan CREATE TABLE, Anda tetap perlu memasukkan tabel tujuan. Tabel tujuan diabaikan selama eksekusi.

Menerapkan pemeriksaan privasi

Ads Data Hub juga mendukung sintaksis SQL untuk membuat tabel hasil sementara yang tunduk pada pemeriksaan privasi.

Untuk membuat tabel yang tunduk pada pemeriksaan privasi, tambahkan klausa OPTIONS ke kueri Anda:

OPTIONS(privacy_checked_export=true)

Contoh ini membuat tabel sementara tingkat sesi dan menerapkan pemeriksaan privasi:

-- Get a list of creative IDs and store in a temporary table called creative_list:
CREATE TEMP TABLE creative_list OPTIONS(privacy_checked_export=true) AS (
  SELECT
    adgroup_id,
    advertiser_id,
    creative_id
  FROM
    adh.dv360_youtube_impressions
);

Contoh ini membuat tabel persisten, menerapkan pemeriksaan privasi, dan mengekspornya ke project Google Cloud Anda:

-- Get a list of creative IDs and store in a persistent table called creative_list:
CREATE TABLE project_name.dataset_name.creative_list` OPTIONS(privacy_checked_export=true) AS (
  SELECT
    adgroup_id,
    advertiser_id,
    creative_id
  FROM
    adh.dv360_youtube_impressions
);

Mengekspor beberapa tabel menggunakan satu kueri

Ads Data Hub mendukung sintaksis SQL yang fleksibel untuk mengekspor tabel hasil yang dapat dilihat jika satu tabel per kueri tidak cukup. Tabel ini tunduk pada pemeriksaan privasi yang sama yang diterapkan di seluruh Ads Data Hub.

Sintaksis untuk mengekspor tabel bersama dengan ekspresi SQL utama adalah:

CREATE TABLE PROJECT_NAME.DATASET.TABLE_NAME
  OPTIONS(privacy_checked_export=true) AS query_statement;

Catatan: Sintaksis CREATE TABLE tanpa OPTIONS(privacy_checked_export=true) membuat tabel persisten yang tidak dapat dilihat di namespace tmp.* yang dihapus setelah 72 jam (waktu ini dapat berubah).

Misalnya, untuk mengekspor tabel ke tujuan BigQuery PROJECT_NAME.DATASET.TABLE_NAME yang berisi jumlah baris untuk setiap ID kampanye dari tabel adh.google_ads_impressions:

CREATE TABLE PROJECT_NAME.DATASET.TABLE_NAME
  OPTIONS(privacy_checked_export=true) AS
  SELECT campaign_id, COUNT(*) AS ct
  FROM adh.google_ads_impressions
  GROUP BY campaign_id;

Contoh berikut memperluas ide ini dan menggunakan kueri yang sama untuk mengekspor dua tabel ke BigQuery:

CREATE TABLE PROJECT_NAME.DATASET.TABLE_NAME
  OPTIONS(privacy_checked_export=true) AS
  SELECT campaign_id, COUNT(*) AS ct
  FROM adh.google_ads_impressions
  GROUP BY campaign_id;

CREATE TABLE PROJECT_NAME.DATASET.TABLE_NAME_2
  OPTIONS(privacy_checked_export=true) AS
  SELECT advertiser_id, COUNT(*) AS ct
  FROM adh.google_ads_impressions
  GROUP BY advertiser_id;

Tabel juga dapat dirujuk dalam kueri yang sama saat tabel tersebut dibuat. Misalnya, kueri berikut menghasilkan dua tabel:

CREATE TABLE PROJECT_NAME.DATASET.TABLE_NAME
  OPTIONS(privacy_checked_export=true) AS
  SELECT campaign_id, COUNT(*) AS ct
  FROM adh.google_ads_impressions
  GROUP BY campaign_id;

SELECT ct FROM PROJECT_NAME.DATASET.TABLE_NAME;

• Tabel pertama dibuat di PROJECT_NAME.DATASET.TABLE_NAME,dengan kolom campaign_id dan ct.
• Tabel kedua dibuat di lokasi yang ditentukan di kolom Destination table dari argumen tugas, dengan kolom ct.

Menambahkan ringkasan baris yang difilter

Anda juga dapat menambahkan ringkasan baris yang difilter ke tabel ini. Baca tentang ringkasan baris yang difilter.

Memberi nama beberapa tabel saat runtime

Saat membuat beberapa tabel dalam kueri, ada dua cara untuk menamainya:

• Beri nama tabel secara eksplisit di SQL menggunakan format berikut: PROJECT_NAME.DATASET.TABLE_NAME.
• Gunakan parameter sebagai placeholder di SQL, lalu beri nama tabel saat runtime.