SET Tag

Berlaku untuk:ditandai dengan ya Databricks SQL ditandai dengan ya Databricks Runtime 16.1 ke atas

Mengatur tag pada katalog, skema, tabel, tampilan, volume, kolom, fungsi, atau objek metadata eksternal.

Important

Mengatur tag pada objek metadata eksternal ada di Pratinjau Umum dan memerlukan Databricks Runtime 18.2 atau lebih tinggi.

Untuk menambahkan tag ke objek yang dapat diamankan Katalog Unity, Anda harus memiliki objek atau memiliki semua hak istimewa berikut:

  • APPLY TAG pada objek
  • USE SCHEMA pada skema induk objek
  • USE CATALOG pada katalog induk objek

Objek metadata eksternal tidak terkandung dalam katalog atau skema, jadi USE CATALOG dan USE SCHEMA tidak berlaku.

Jika tag diatur, Anda juga memerlukan ASSIGN izin pada tag yang diatur

Sintaksis

SET TAG ON
    { CATALOG catalog_name |
      COLUMN relation_name . column_name |
      EXTERNAL METADATA external_metadata_name |
      { FUNCTION | PROCEDURE } function_name |
      { SCHEMA | DATABASE } schema_name |
      TABLE relation_name |
      VIEW  relation_name |
      VOLUME volume_name }
    tag_key [ = tag_value ]

Parameter-parameternya

  • CATALOG catalog_name

    Nama katalog yang akan diberi tag.

  • COLUMN relation_name . column_name

    Nama kolom yang memenuhi syarat untuk diberi tag. relation_name harus mengidentifikasi tampilan atau tabel. relation_name tidak boleh menyertakan spesifikasi temporal atau spesifikasi opsi.

  • EXTERNAL_METADATA_NAME METADATA EKSTERNAL

    Nama objek metadata eksternal yang akan diberi tag.

  • { FUNCTION | PROCEDURE } function_name

    Nama fungsi atau prosedur yang akan diberi tag. FUNCTION dan PROCEDURE dapat dipertukarkan.

  • SCHEMA schema_name

    Nama skema yang akan ditandai.

  • TABLE nama_relasi

    Nama tabel atau tampilan untuk diberi tag. Nama tidak boleh menyertakan spesifikasi temporal atau spesifikasi opsi.

  • TAMPILAN relation_name

    Nama tampilan yang akan diberi tag.

  • VOLUME volume_name

    Nama volume yang akan diberi tag.

  • tag_key

    Pengidentifikasi. Jika penetapan tag dengan kunci yang sama sudah ada, maka pengecualian akan muncul.

  • tag_value

    Pengidentifikasi opsional. Jika tidak ditentukan, penetapan tag akan ditetapkan sebagai kunci-saja.

Contoh

> SET TAG ON CATALOG catalog `cost_center` = `hr`;

> UNSET TAG ON CATALOG catalog cost_center;

> SET TAG ON TABLE catalog.schema.table cost_center = hr;

> UNSET TAG ON TABLE catalog.schema.table cost_center;

> SET TAG ON COLUMN table.ssn pii;

> UNSET TAG ON COLUMN table.ssn pii;

> SET TAG ON FUNCTION catalog.schema.my_func cost_center = hr;

> UNSET TAG ON FUNCTION catalog.schema.my_func cost_center;

> SELECT catalog_name, schema_name, table_name, tag_name, tag_value
    FROM information_schema.column_tags
    WHERE tag_name = 'pii' AND schema_name = 'default';
  table_name column_name
  ---------- -----------
  table      ssn
  • Last updated on