Mengonfigurasi setelan tabel tambahan

Dokumen ini menunjukkan cara mengonfigurasi setelan tabel tambahan dalam file definisi tabel. Dengan inti Dataform, Anda dapat menentukan pre_operations dan post_operations untuk menjalankan pernyataan SQL sebelum atau setelah pembuatan tabel. Anda juga dapat mengganti setelan tabel, seperti database atau schema, dan menonaktifkan pembuatan tabel.

Sebelum memulai

  1. Di konsol Google Cloud, buka halaman Dataform.

    Buka Dataform

  2. Pilih atau buat repositori.

  3. Pilih atau buat ruang kerja pengembangan.

  4. Membuat tabel.

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan guna mengonfigurasi setelan tabel tambahan, minta administrator untuk memberi Anda peran IAM Dataform Editor (roles/dataform.editor) di ruang kerja. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Mengganti setelan tabel

Anda dapat mengganti skema, database, dan nama tabel yang dipilih.

Secara default, tabel mengikuti konfigurasi skema dan database yang Anda tetapkan di dataform.json. Nama tabel sama dengan nama file SQLX definisi tabel.

Untuk mengganti skema dan nama tabel yang dipilih, ikuti langkah-langkah berikut:

  1. Buka ruang kerja pengembangan Anda.

  2. Di panel Files, luaskan definitions/.

  3. Buka file definisi tabel SQLX.

  4. Di blok config, masukkan cuplikan kode berikut:

     {
       schema: "OVERRIDDEN_SCHEMA",
       database: "OVERRIDDEN_DATABASE",
       name: "OVERRIDDEN_NAME"
     }
    

    Ganti kode berikut:

    • OVERRIDDEN_SCHEMA: set data BigQuery tempat Anda ingin membuat tabel

    • OVERRIDDEN_DATABASE: ID project BigQuery tempat Anda ingin membuat tabel

    • OVERRIDDEN_NAME: nama untuk tabel, yang berbeda dengan nama file definisi tabel SQLX

  5. Opsional: Klik Format.

Mereferensikan tabel dengan nama tabel yang diganti

  • Untuk mereferensikan tabel dengan nama tabel yang diganti, dalam fungsi ref, masukkan nama tabel yang diganti yang ditetapkan di name: "".

Contoh kode berikut mereferensikan tabel dengan nama yang diganti menjadi overridden_name:

  SELECT * FROM ${ref("overridden_name")}

Menentukan pernyataan SQL yang akan dieksekusi sebelum pembuatan tabel

Anda dapat mengonfigurasi Dataform untuk menjalankan satu atau beberapa pernyataan SQL sebelum membuat tabel yang dipilih di BigQuery. Untuk mengeksekusi pernyataan SQL sebelum Dataform membuat tabel yang dipilih, tambahkan pernyataan Anda ke blok pre_operations dalam file SQLX definisi tabel.

Untuk membuat pernyataan SQL kustom yang dijalankan sebelum Dataform membuat tabel tertentu, ikuti langkah-langkah berikut:

  1. Buka ruang kerja pengembangan Anda.

  2. Di panel Files, luaskan definitions/.

  3. Buka file definisi tabel SQLX.

  4. Di luar blok config, masukkan pre_operations { ... }.

  5. Di dalam pre_operations { ... }, tambahkan pernyataan SQL Anda.

  6. Opsional: Untuk menambahkan beberapa pernyataan, pisahkan dengan ---.

  7. Opsional: Klik Format.

Contoh kode berikut menunjukkan pernyataan pre_operations yang membuat fungsi sementara yang dapat digunakan dalam pernyataan pilih:

  pre_operations {
    CREATE TEMP FUNCTION AddFourAndDivide(x INT64, y INT64)
      RETURNS FLOAT64
      AS ((x + 4) / y);
  }

Menentukan pernyataan SQL yang akan dieksekusi setelah pembuatan tabel

Anda dapat mengonfigurasi Dataform untuk menjalankan satu atau beberapa pernyataan SQL setelah membuat tabel yang dipilih di BigQuery. Untuk mengeksekusi pernyataan SQL setelah Dataform membuat tabel yang dipilih, tambahkan pernyataan Anda ke blok post_operations dalam file SQLX definisi tabel. Anda dapat menambahkan beberapa pernyataan SQL ke blok post_operations.

Untuk membuat pernyataan SQL kustom yang dijalankan setelah Dataform membuat tabel tertentu, ikuti langkah-langkah berikut:

  1. Buka ruang kerja pengembangan Anda.

  2. Di panel Files, luaskan definitions/.

  3. Buka file definisi tabel SQLX.

  4. Di luar blok config, masukkan post_operations { ... }.

  5. Di dalam post_operations { ... }, tambahkan pernyataan SQL Anda.

  6. Opsional: Klik Format.

Contoh kode berikut menunjukkan pernyataan post_operations yang memberikan akses grup ke tabel yang dibuat:

    post_operations {
      GRANT `roles/bigquery.dataViewer`
      ON
      TABLE ${self()}
      TO "group:allusers@example.com", "user:otheruser@example.com"
    }

Menonaktifkan pembuatan tabel

Untuk menghentikan Dataform membuat tabel yang dipilih di BigQuery, Anda dapat menonaktifkan tabel dalam file definisi tabel SQLX-nya. Dataform menyimpan tabel yang dinonaktifkan dalam grafik dependensi, tetapi tidak mengompilasi dan membuatnya. Hal ini dapat berguna, misalnya, jika tabel gagal dan Anda tidak ingin seluruh alur kerja gagal saat Anda memperbaiki masalah tersebut.

Untuk menonaktifkan tabel, ikuti langkah-langkah berikut:

  1. Buka ruang kerja pengembangan Anda.

  2. Di panel Files, luaskan definitions/.

  3. Pilih file definisi tabel SQLX.

  4. Di blok config file, masukkan disabled: true.

  5. Opsional: Klik Format.

Contoh kode berikut menunjukkan tabel yang dinonaktifkan:

  config {
    type: "table",
    disabled: true
  }

  select * from ${ref("source_data")}

Langkah selanjutnya