entity-tag-assignments opdrachtgroep

De entity-tag-assignments opdrachtgroep in de Databricks CLI bevat opdrachten voor het maken, bijwerken, verwijderen en vermelden van tagtoewijzingen in Unity Catalog-entiteiten. Tags zijn kenmerken die sleutels en optionele waarden bevatten die u kunt gebruiken om entiteiten in Unity Catalog te organiseren en te categoriseren. Zie Tags toepassen op beveiligbare objecten van Unity Catalog.

databricks entity-tag-assignments maken

Maak een tagtoewijzing voor een Unity Catalog-entiteit.

Als u tags wilt toevoegen aan Unity Catalog-entiteiten, moet u eigenaar zijn van de entiteit of de volgende bevoegdheden hebben:

• TAG TOEPASSEN op de entiteit
• USE SCHEMA in het bovenliggende schema van de entiteit
• USE CATALOG in de bovenliggende catalogus van de entiteit

Als u een beheerde tag wilt toevoegen aan Unity Catalog-entiteiten, moet u ook de machtiging TOEWIJZEN of BEHEREN hebben voor het tagbeleid. Zie Machtigingen voor tagbeleid beheren.

databricks entity-tag-assignments create ENTITY_NAME TAG_KEY ENTITY_TYPE [flags]

Arguments

ENTITY_NAME

    De volledig gekwalificeerde naam van de entiteit waaraan de tag is toegewezen.

TAG_KEY

    De sleutel van het label.

ENTITY_TYPE

    Het type entiteit waaraan de tag is toegewezen. Toegestane waarden zijn: catalogs, schemas, tables, , columns. volumes

Opties

--json JSON

    De inline JSON-tekenreeks of het @path naar het JSON-bestand met de aanvraagbody

--tag-value string

    De waarde van de tag.

Globale vlaggen

Voorbeelden

In het volgende voorbeeld wordt een tagtoewijzing voor een tabel gemaakt:

databricks entity-tag-assignments create my_catalog.my_schema.my_table environment tables --tag-value production

In het volgende voorbeeld wordt een tagtoewijzing gemaakt met behulp van JSON:

databricks entity-tag-assignments create my_catalog.my_schema.my_table department tables --json '{"tag_value": "finance"}'

databricks entity-tag-assignments verwijderen

Verwijder een tagtoewijzing voor een Unity Catalog-entiteit op basis van de sleutel.

Als u tags uit Unity Catalog-entiteiten wilt verwijderen, moet u eigenaar zijn van de entiteit of de volgende bevoegdheden hebben:

• TAG TOEPASSEN op de entiteit
• USE_SCHEMA in het bovenliggende schema van de entiteit
• USE_CATALOG op de bovenliggende catalogus van de entiteit

Als u een beheerde tag wilt verwijderen uit Unity Catalog-entiteiten, moet u ook de machtiging TOEWIJZEN of BEHEREN hebben voor het tagbeleid. Zie Machtigingen voor tagbeleid beheren.

databricks entity-tag-assignments delete ENTITY_TYPE ENTITY_NAME TAG_KEY [flags]

Arguments

ENTITY_TYPE

    Het type entiteit waaraan de tag is toegewezen. Toegestane waarden zijn: catalogs, schemas, tables, , columns. volumes

ENTITY_NAME

    De volledig gekwalificeerde naam van de entiteit waaraan de tag is toegewezen.

TAG_KEY

    De sleutel van de tag die u wilt verwijderen.

Opties

Globale vlaggen

Voorbeelden

In het volgende voorbeeld wordt een tagtoewijzing uit een tabel verwijderd:

databricks entity-tag-assignments delete tables my_catalog.my_schema.my_table environment

get databricks entity-tag-assignments

Haal een tagtoewijzing op voor een Unity Catalog-entiteit op tagsleutel.

databricks entity-tag-assignments get ENTITY_TYPE ENTITY_NAME TAG_KEY [flags]

Arguments

ENTITY_TYPE

    Het type entiteit waaraan de tag is toegewezen. Toegestane waarden zijn: catalogs, schemas, tables, , columns. volumes

ENTITY_NAME

    De volledig gekwalificeerde naam van de entiteit waaraan de tag is toegewezen.

TAG_KEY

    De sleutel van het label.

Opties

Globale vlaggen

Voorbeelden

In het volgende voorbeeld wordt een tagtoewijzing voor een tabel opgehaald:

databricks entity-tag-assignments get tables my_catalog.my_schema.my_table environment

lijst met databricks entity-tag-assignments

Tagtoewijzingen weergeven voor een Unity Catalog-entiteit.

databricks entity-tag-assignments list ENTITY_TYPE ENTITY_NAME [flags]

Arguments

ENTITY_TYPE

    Het type entiteit waaraan de tag is toegewezen. Toegestane waarden zijn: catalogs, schemas, tables, , columns. volumes

ENTITY_NAME

    De volledig gekwalificeerde naam van de entiteit waaraan de tag is toegewezen.

Opties

--max-results int

    Het maximum aantal resultaten dat moet worden teruggegeven.

--page-token string

    Token om de volgende pagina met resultaten op te halen.

Globale vlaggen

Voorbeelden

In het volgende voorbeeld ziet u alle tagtoewijzingen voor een tabel:

databricks entity-tag-assignments list tables my_catalog.my_schema.my_table

In het volgende voorbeeld ziet u tagtoewijzingen met paginering:

databricks entity-tag-assignments list tables my_catalog.my_schema.my_table --max-results 10

Update van databricks entity-tag-assignments

Werk een bestaande tagtoewijzing voor een Unity Catalog-entiteit bij.

Als u tags wilt bijwerken naar Unity Catalog-entiteiten, moet u eigenaar zijn van de entiteit of over de volgende bevoegdheden beschikken:

• TAG TOEPASSEN op de entiteit
• USE SCHEMA in het bovenliggende schema van de entiteit
• USE CATALOG in de bovenliggende catalogus van de entiteit

Als u een beheerde tag wilt bijwerken naar Unity Catalog-entiteiten, moet u ook de machtiging TOEWIJZEN of BEHEREN hebben voor het tagbeleid. Zie Machtigingen voor tagbeleid beheren.

databricks entity-tag-assignments update ENTITY_TYPE ENTITY_NAME TAG_KEY UPDATE_MASK [flags]

Arguments

ENTITY_TYPE

    Het type entiteit waaraan de tag is toegewezen. Toegestane waarden zijn: catalogs, schemas, tables, , columns. volumes

ENTITY_NAME

    De volledig gekwalificeerde naam van de entiteit waaraan de tag is toegewezen.

TAG_KEY

    De sleutel van het label.

UPDATE_MASK

    Het veldmasker moet één tekenreeks zijn, met meerdere velden gescheiden door komma's (geen spaties). Het veldpad is relatief ten opzichte van het resourceobject, met behulp van een punt (.) om door subvelden te navigeren (bijvoorbeeld author.given_name). Specificatie van elementen in reeks of map-velden is niet toegestaan, omdat alleen de gehele verzamelingsveld kan worden opgegeven. Veldnamen moeten exact overeenkomen met de resourceveldnamen.

    Een sterretje (*) veldmasker geeft volledige vervanging aan. Het is raadzaam om de velden die worden bijgewerkt altijd expliciet weer te geven en jokertekens te voorkomen, omdat dit kan leiden tot onbedoelde resultaten als de API in de toekomst verandert.

Opties

--json JSON

    De inline JSON-tekenreeks of het @path naar het JSON-bestand met de aanvraagbody

--tag-value string

    De waarde van de tag.

Globale vlaggen

Voorbeelden

In het volgende voorbeeld wordt een tagtoewijzing voor een tabel bijgewerkt:

databricks entity-tag-assignments update tables my_catalog.my_schema.my_table environment "tag_value" --tag-value staging

In het volgende voorbeeld wordt een tagtoewijzing bijgewerkt met behulp van JSON:

databricks entity-tag-assignments update tables my_catalog.my_schema.my_table environment "tag_value" --json '{"tag_value": "development"}'

Globale vlaggen

--debug

  Of u logboekregistratie voor foutopsporing wilt inschakelen.

-h of --help

    Help weergeven voor de Databricks CLI, de bijbehorende opdrachtgroep of de bijbehorende opdracht.

--log-file snaar

    Een tekenreeks die het bestand aangeeft waar uitvoerlogboeken naar moeten worden geschreven. Als deze vlag niet is opgegeven, is het standaardinstelling om uitvoerlogboeken naar stderr te schrijven.

--log-format formatteren

    Het logformaat type, text of json. De standaardwaarde is text.

--log-level snaar

    Een tekenreeks die het niveau van de logboekindeling vertegenwoordigt. Als dit niet is opgegeven, wordt het niveau van de logboekindeling uitgeschakeld.

-o, --output Type

    Het type uitvoer van de opdracht, text of json. De standaardwaarde is text.

-p, --profile snaar

    De naam van het profiel in het ~/.databrickscfg bestand dat moet worden gebruikt om de opdracht uit te voeren. Als deze vlag niet is opgegeven en hij bestaat, wordt het profiel met de naam DEFAULT gebruikt.

--progress-format formatteren

    De indeling voor het weergeven van voortgangslogboeken: default, append, inplaceof json

-t, --target snaar

    Indien van toepassing, het bundeldoel dat moet worden gebruikt