Tampilan JOBS_BY_ORGANIZATION

Tampilan INFORMATION_SCHEMA.JOBS_BY_ORGANIZATION berisi metadata mendekati real-time tentang semua tugas yang dikirimkan dalam organisasi yang terkait dengan project saat ini.

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk membuat kueri tampilan INFORMATION_SCHEMA.JOBS_BY_ORGANIZATION, minta administrator untuk memberi Anda peran IAM BigQuery Resource Viewer (roles/bigquery.resourceViewer) di organisasi Anda. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses.

Peran yang telah ditentukan ini berisi izin bigquery.jobs.listAll, yang diperlukan untuk membuat kueri tampilan INFORMATION_SCHEMA.JOBS_BY_ORGANIZATION.

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

Tabel skema hanya tersedia bagi pengguna dengan organisasi Google Cloud yang ditentukan.

Untuk mengetahui informasi selengkapnya tentang izin BigQuery, lihat Kontrol akses dengan IAM.

Skema

Data pokok dipartisi oleh kolom creation_time serta dikelompokkan menurut project_id dan user_email. Kolom query_info berisi informasi tambahan tentang tugas kueri Anda.

Tampilan INFORMATION_SCHEMA.JOBS_BY_ORGANIZATION memiliki skema berikut:

Nama kolom	Data type	Nilai
`bi_engine_statistics`	`RECORD`	Jika project dikonfigurasi untuk menggunakan Antarmuka BI Engine SQL, maka kolom ini berisi BiEngineStatistics. Atau `NULL`.
`cache_hit`	`BOOLEAN`	Apakah hasil kueri tugas ini berasal dari cache. Jika Anda memiliki tugas pernyataan multi-kueri, `cache_hit` untuk kueri induk Anda adalah `NULL`.
`creation_time`	`TIMESTAMP`	(Kolom partisi) Waktu pembuatan tugas ini. Partisi didasarkan pada waktu UTC stempel waktu ini.
`destination_table`	`RECORD`	Tabel tujuan untuk hasil, jika ada.
`end_time`	`TIMESTAMP`	Waktu berakhir tugas ini, dalam milidetik sejak epoch. Kolom ini menunjukkan waktu saat tugas memasuki status `DONE`.
`error_result`	`RECORD`	Detail error sebagai objek ErrorProto.
`job_id`	`STRING`	ID tugas. Misalnya, `bquxjob_1234`.
`job_stages`	`RECORD`	Tahap kueri tugas. Catatan: Nilai kolom ini kosong untuk kueri yang membaca dari tabel dengan kebijakan akses tingkat baris. Untuk mengetahui informasi selengkapnya, lihat praktik terbaik untuk keamanan tingkat baris di BigQuery.
`job_type`	`STRING`	Jenis tugas. Dapat berupa `QUERY`, `LOAD`, `EXTRACT`, `COPY`, atau `NULL`. Nilai `NULL` menunjukkan tugas internal, seperti evaluasi pernyataan tugas skrip atau pemuatan ulang tampilan terwujud.
`labels`	`RECORD`	Array label yang diterapkan ke tugas sebagai pasangan nilai kunci.
`parent_job_id`	`STRING`	ID tugas induk, jika ada.
`priority`	`STRING`	Prioritas tugas ini. Nilai yang valid mencakup `INTERACTIVE`, dan `BATCH`.
`project_id`	`STRING`	(Kolom pengelompokkan) ID project.
`project_number`	`INTEGER`	Nomor project.
`query`	`STRING`	Teks kueri SQL. Hanya tampilan `JOBS_BY_PROJECT` yang memiliki kolom kueri.
`referenced_tables`	`RECORD`	Array tabel yang direferensikan oleh tugas. Hanya diisi untuk tugas kueri yang bukan cache ditemukan.
`reservation_id`	`STRING`	Nama reservasi utama yang ditetapkan untuk tugas ini, dalam format `RESERVATION_ADMIN_PROJECT:RESERVATION_LOCATION.RESERVATION_NAME`. Dalam output ini: `RESERVATION_ADMIN_PROJECT`: nama project Google Cloud yang mengelola reservasi `RESERVATION_LOCATION`: lokasi pemesanan `RESERVATION_NAME`: nama pemesanan
`session_info`	`RECORD`	Detail tentang sesi tempat tugas ini dijalankan, jika ada. (Pratinjau)
`start_time`	`TIMESTAMP`	Waktu mulai tugas ini, dalam milidetik sejak epoch. Kolom ini menunjukkan waktu saat tugas bertransisi dari status `PENDING` ke `RUNNING` atau `DONE`.
`state`	`STRING`	Status tugas yang berjalan. Status yang valid mencakup `PENDING`, `RUNNING`, dan `DONE`.
`statement_type`	`STRING`	Jenis pernyataan kueri. Misalnya, `DELETE`, `INSERT`, `SCRIPT`, `SELECT`, atau `UPDATE`. Lihat QueryStatementType untuk mengetahui daftar nilai yang valid.
`timeline`	`RECORD`	Linimasa kueri tugas. Berisi snapshot eksekusi kueri.
`total_bytes_billed`	`INTEGER`	Jika project dikonfigurasi untuk menggunakan harga sesuai permintaan, maka kolom ini berisi total byte yang ditagih untuk tugas tersebut. Jika project dikonfigurasi untuk menggunakan harga tetap, Anda tidak akan dikenai biaya untuk byte dan kolom ini hanya bersifat informasi. Catatan: Nilai kolom ini kosong untuk kueri yang membaca dari tabel dengan kebijakan akses tingkat baris. Untuk mengetahui informasi selengkapnya, lihat praktik terbaik untuk keamanan tingkat baris di BigQuery.
`total_bytes_processed`	`INTEGER`	Total byte yang diproses oleh tugas. Catatan: Nilai kolom ini kosong untuk kueri yang membaca dari tabel dengan kebijakan akses tingkat baris. Untuk mengetahui informasi selengkapnya, lihat praktik terbaik untuk keamanan tingkat baris di BigQuery.
`total_modified_partitions`	`INTEGER`	Jumlah total partisi yang diubah oleh tugas. Kolom ini diisi untuk tugas `LOAD` dan `QUERY`.
`total_slot_ms`	`INTEGER`	Masukkan milidetik untuk tugas selama keseluruhan durasinya dalam status `RUNNING`, termasuk percobaan ulang.
`transaction_id`	`STRING`	ID transaksi tempat tugas ini berjalan, jika ada. (Pratinjau)
`user_email`	`STRING`	(Kolom pengelompokan) Alamat email atau akun layanan pengguna yang menjalankan tugas.
`query_info.resource_warning`	`STRING`	Pesan peringatan yang muncul jika penggunaan resource selama pemrosesan kueri berada di atas ambang batas internal sistem. Tugas kueri yang berhasil dapat mengisi kolom `resource_warning`. Dengan `resource_warning`, Anda akan mendapatkan titik data tambahan untuk mengoptimalkan kueri dan menyiapkan pemantauan tren performa kumpulan kueri yang setara menggunakan `query_hashes`.
`query_info.query_hashes.normalized_literals`	`STRING`	Berisi hash kueri. `normalized_literals` adalah hash `STRING` heksadesimal yang mengabaikan komentar, parameter value, UDF, dan literal. Kolom ini muncul untuk kueri GoogleSQL yang berhasil dan tidak menemukan cache.
`query_info.performance_insights`	`RECORD`	Insight performa untuk tugas.
`query_info.optimization_details`	`STRUCT`	Pengoptimalan berbasis histori untuk tugas.
`transferred_bytes`	`INTEGER`	Total byte yang ditransfer untuk kueri lintas-cloud, seperti tugas transfer lintas-cloud BigQuery Omni.
`materialized_view_statistics`	`RECORD`	Statistik tampilan terwujud yang dipertimbangkan dalam tugas kueri. (Pratinjau)

Retensi data

Tabel virtual ini berisi tugas yang sedang berjalan dan histori tugas selama 180 hari terakhir.

Cakupan dan sintaksis

Kueri terhadap tabel virtual ini harus menyertakan penentu region. Tabel berikut menjelaskan cakupan region untuk tabel virtual ini:

Nama tabel virtual	Cakupan resource	Cakupan region
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.JOBS_BY_ORGANIZATION	Organisasi yang berisi project yang ditentukan	`REGION`

Ganti kode berikut:

Opsional: PROJECT_ID: ID project Google Cloud Anda. Jika tidak ditentukan, project default akan digunakan.
REGION: nama region set data apa pun. Misalnya, region-us.

Catatan: Anda harus menentukan lokasi untuk membuat kueri tampilan INFORMATION_SCHEMA dan lokasi eksekusi kueri harus cocok dengan region tampilan INFORMATION_SCHEMA.

Contoh

Untuk menjalankan kueri terhadap project selain project default Anda, tambahkan project ID dalam format berikut:

`PROJECT_ID`.`region-REGION_NAME`.INFORMATION_SCHEMA.JOBS_BY_ORGANIZATION

Ganti kode berikut:

PROJECT_ID: ID project
REGION_NAME: region untuk project Anda

Misalnya, `myproject`.`region-us`.INFORMATION_SCHEMA.JOBS_BY_ORGANIZATION.

5 tugas teratas yang memindai byte terbanyak saat ini

Contoh berikut menunjukkan cara menemukan lima tugas yang memindai byte terbanyak di suatu organisasi untuk hari ini. Anda dapat memfilter lebih lanjut di statement_type guna membuat kueri untuk informasi tambahan seperti pemuatan, ekspor, dan kueri.

SELECT
  job_id,
  user_email,
  total_bytes_billed
FROM
  `region-us`.INFORMATION_SCHEMA.JOBS_BY_ORGANIZATION
WHERE
  EXTRACT(DATE FROM  creation_time) = current_date()
ORDER BY
  total_bytes_billed DESC
LIMIT 5;

Hasilnya mirip dengan berikut ini:

+--------------+--------------+---------------------------+
| job_id       |  user_email  |  total_bytes_billed       |
+--------------+--------------+---------------------------+
| bquxjob_1    |  abc@xyz.com |    999999                 |
| bquxjob_2    |  def@xyz.com |    888888                 |
| bquxjob_3    |  ghi@xyz.com |    777777                 |
| bquxjob_4    |  jkl@xyz.com |    666666                 |
| bquxjob_5    |  mno@xyz.com |    555555                 |
+--------------+--------------+---------------------------+

Melihat insight performa untuk kueri

Contoh berikut menampilkan semua tugas kueri yang memiliki insight performa dari organisasi Anda dalam 30 hari terakhir, beserta URL yang tertaut ke grafik eksekusi kueri di Konsol Google Cloud.

SELECT
  `bigquery-public-data`.persistent_udfs.job_url(
    project_id || ':us.' || job_id) AS job_url,
  query_info.performance_insights
FROM
  `region-us`.INFORMATION_SCHEMA.JOBS_BY_ORGANIZATION
WHERE
  DATE(creation_time) >= CURRENT_DATE - 30 -- scan 30 days of query history
  AND job_type = 'QUERY'
  AND state = 'DONE'
  AND error_result IS NULL
  AND statement_type != 'SCRIPT'
  AND EXISTS ( -- Only include queries which had performance insights
    SELECT 1
    FROM UNNEST(
      query_info.performance_insights.stage_performance_standalone_insights
    )
    WHERE slot_contention OR insufficient_shuffle_quota
    UNION ALL
    SELECT 1
    FROM UNNEST(
      query_info.performance_insights.stage_performance_change_insights
    )
    WHERE input_data_change.records_read_diff_percentage IS NOT NULL
  );