Kommentar
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
Anmärkning
Den här informationen gäller för Databricks CLI-versionerna 0.205 och senare. Databricks CLI finns i offentlig förhandsversion.
Databricks CLI-användning omfattas av Databricks-licensen och Databricks sekretessmeddelande, inklusive eventuella användningsdatabestämmelser.
Kommandogruppen entity-tag-assignments i Databricks CLI innehåller kommandon för att skapa, uppdatera, ta bort och lista taggtilldelningar i Unity Catalog-entiteter. Taggar är attribut som innehåller nycklar och valfria värden som du kan använda för att organisera och kategorisera entiteter i Unity Catalog. Se Tillämpa taggar på skyddsbara objekt i Unity Catalog.
databricks entity-tag-assignments create
Skapa en taggtilldelning för en Unity Catalog-entitet.
Om du vill lägga till taggar i Unity Catalog-entiteter måste du äga entiteten eller ha följande behörigheter:
- TILLÄMPA TAGG på entiteten
- USE SCHEMA i entitetens överordnade schema
- USE CATALOG i entitetens överordnade katalog
Om du vill lägga till en styrd tagg i Unity Catalog-entiteter måste du också ha behörigheten TILLDELA eller HANTERA för taggprincipen. Se Hantera taggpolicybehörigheter.
databricks entity-tag-assignments create ENTITY_NAME TAG_KEY ENTITY_TYPE [flags]
Arguments
ENTITY_NAME
Det fullständigt kvalificerade namnet på den entitet som taggen tilldelas till.
TAG_KEY
Nyckeln till taggen.
ENTITY_TYPE
Typen av entitet som taggen har tilldelats till. Tillåtna värden är: catalogs, schemas, tables, columns, volumes.
Alternativ
--json JSON
Den infogade JSON-strängen eller @path till JSON-filen med begärandetexten
--tag-value string
Taggens värde.
Exempel
I följande exempel skapas en taggtilldelning för en tabell:
databricks entity-tag-assignments create my_catalog.my_schema.my_table environment tables --tag-value production
I följande exempel skapas en taggtilldelning med JSON:
databricks entity-tag-assignments create my_catalog.my_schema.my_table department tables --json '{"tag_value": "finance"}'
databricks entity-tag-assignments delete
Ta bort en taggtilldelning för en Unity Catalog-entitet med dess nyckel.
Om du vill ta bort taggar från Unity Catalog-entiteter måste du äga entiteten eller ha följande behörigheter:
- TILLÄMPA TAGG på entiteten
- USE_SCHEMA i entitetens överordnade schema
- USE_CATALOG i entitetens överordnade katalog
Om du vill ta bort en styrd tagg från Unity Catalog-entiteter måste du också ha behörigheten TILLDELA eller HANTERA för taggprincipen. Se Hantera taggpolicybehörigheter.
databricks entity-tag-assignments delete ENTITY_TYPE ENTITY_NAME TAG_KEY [flags]
Arguments
ENTITY_TYPE
Typen av entitet som taggen har tilldelats till. Tillåtna värden är: catalogs, schemas, tables, columns, volumes.
ENTITY_NAME
Det fullständigt kvalificerade namnet på den entitet som taggen tilldelas till.
TAG_KEY
Nyckeln för taggen som ska tas bort.
Alternativ
Exempel
I följande exempel tas en taggtilldelning bort från en tabell:
databricks entity-tag-assignments delete tables my_catalog.my_schema.my_table environment
databricks entity-tag-assignments get
Hämta en taggtilldelning för en Unity Catalog-entitet med taggnyckel.
databricks entity-tag-assignments get ENTITY_TYPE ENTITY_NAME TAG_KEY [flags]
Arguments
ENTITY_TYPE
Typen av entitet som taggen har tilldelats till. Tillåtna värden är: catalogs, schemas, tables, columns, volumes.
ENTITY_NAME
Det fullständigt kvalificerade namnet på den entitet som taggen tilldelas till.
TAG_KEY
Nyckeln till taggen.
Alternativ
Exempel
I följande exempel hämtas en taggtilldelning för en tabell:
databricks entity-tag-assignments get tables my_catalog.my_schema.my_table environment
databricks entity-tag-assignments-lista
Lista taggtilldelningar för en Unity Catalog-entitet.
Viktigt!
API:et är som standard sidnumrerat, en sida kan innehålla noll resultat samtidigt som en next_page_token. Klienter måste fortsätta att läsa sidor tills next_page_token saknas, vilket är den enda indikationen på att resultatet har nåtts.
databricks entity-tag-assignments list ENTITY_TYPE ENTITY_NAME [flags]
Arguments
ENTITY_TYPE
Typen av entitet som taggen har tilldelats till. Tillåtna värden är: catalogs, schemas, tables, columns, volumes.
ENTITY_NAME
Det fullständigt kvalificerade namnet på den entitet som taggen tilldelas till.
Alternativ
--max-results int
Maximalt antal resultat som ska returneras.
--page-token string
Token för att hämta nästa sida med resultat.
Exempel
I följande exempel visas alla taggtilldelningar för en tabell:
databricks entity-tag-assignments list tables my_catalog.my_schema.my_table
I följande exempel visas taggtilldelningar med sidnumrering:
databricks entity-tag-assignments list tables my_catalog.my_schema.my_table --max-results 10
uppdatering av databricks entity-tag-assignments
Uppdatera en befintlig taggtilldelning för en Enhetskatalogentitet.
Om du vill uppdatera taggar till Unity Catalog-entiteter måste du äga entiteten eller ha följande behörigheter:
- TILLÄMPA TAGG på entiteten
- USE SCHEMA i entitetens överordnade schema
- USE CATALOG i entitetens överordnade katalog
Om du vill uppdatera en styrd tagg till Unity Catalog-entiteter måste du också ha behörigheten TILLDELA eller HANTERA för taggprincipen. Se Hantera taggpolicybehörigheter.
databricks entity-tag-assignments update ENTITY_TYPE ENTITY_NAME TAG_KEY UPDATE_MASK [flags]
Arguments
ENTITY_TYPE
Typen av entitet som taggen har tilldelats till. Tillåtna värden är: catalogs, schemas, tables, columns, volumes.
ENTITY_NAME
Det fullständigt kvalificerade namnet på den entitet som taggen tilldelas till.
TAG_KEY
Nyckeln till taggen.
UPDATE_MASK
Fältmasken måste vara en enda sträng med flera fält avgränsade med kommatecken (inga blanksteg). Fältsökvägen är relativ till resursobjektet med hjälp av en punkt (.) för att navigera i underfält (t.ex. author.given_name). Specifikation av element i sekvens- eller kartfält tillåts inte, eftersom endast hela samlingsfältet kan anges. Fältnamn måste exakt matcha resursfältnamnen.
En asterisk (*) fältmask anger fullständig ersättning. Vi rekommenderar att du alltid uttryckligen visar de fält som uppdateras och undviker att använda jokertecken, eftersom det kan leda till oavsiktliga resultat om API:et ändras i framtiden.
Alternativ
--json JSON
Den infogade JSON-strängen eller @path till JSON-filen med begärandetexten
--tag-value string
Taggens värde.
Exempel
I följande exempel uppdateras en taggtilldelning för en tabell:
databricks entity-tag-assignments update tables my_catalog.my_schema.my_table environment "tag_value" --tag-value staging
I följande exempel uppdateras en taggtilldelning med JSON:
databricks entity-tag-assignments update tables my_catalog.my_schema.my_table environment "tag_value" --json '{"tag_value": "development"}'
Globala flaggor
--debug
Om felsökningsloggning ska aktiveras.
-h eller --help
Visa hjälp för Databricks CLI eller den relaterade kommandogruppen eller det relaterade kommandot.
--log-file sträng
En sträng som representerar filen som utdataloggarna ska skrivas till. Om den här flaggan inte anges är standardvärdet att skriva utdataloggar till stderr.
--log-format Format
Loggformattypen, text eller json. Standardvärdet är text.
--log-level sträng
En sträng som representerar loggformatnivån. Om det inte anges inaktiveras loggformatnivån.
-o, --output typ
Kommandots utdatatyp, text eller json. Standardvärdet är text.
-p, --profile sträng
Namnet på profilen i ~/.databrickscfg-filen som ska användas för att köra kommandot. Om den här flaggan inte anges används den namngivna DEFAULT profilen om den finns.
--progress-format Format
Formatet för att visa förloppsloggar: default, append, inplaceeller json
-t, --target sträng
Om tillämpligt, paketmålet som ska användas