external-metadata opdrachtgroep

De external-metadata opdrachtgroep in de Databricks CLI bevat opdrachten voor het registreren en beheren van metagegevens over externe systemen in Unity Catalog.

databricks external-metadata create-external-metadata

Maak een nieuw extern metagegevensobject in de bovenliggende metastore als de aanroeper een metastore-beheerder is of de CREATE_EXTERNAL_METADATA bevoegdheid heeft. Verleent BLADEREN aan alle accountgebruikers wanneer deze standaard zijn gemaakt.

databricks external-metadata create-external-metadata NAME SYSTEM_TYPE ENTITY_TYPE [flags]

Arguments

NAME

    Naam van het externe metagegevensobject.

SYSTEM_TYPE

    Type extern systeem. Ondersteunde waarden: AMAZON_REDSHIFT, AZURE_SYNAPSE, CONFLUENT, , DATABRICKS, GOOGLE_BIGQUERY, KAFKA, MICROSOFT_FABRICLOOKER, , , MICROSOFT_SQL_SERVER, MONGODB, OTHERSAPMYSQLORACLEPOSTGRESQLPOWER_BISALESFORCESERVICENOWSNOWFLAKESTREAM_NATIVETABLEAUTERADATAWORKDAY

ENTITY_TYPE

    Type entiteit binnen het externe systeem.

Opties

--description string

    Vrije tekstbeschrijving door gebruiker verstrekt.

--json JSON

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

--owner string

    Eigenaar van het externe metagegevensobject.

--url string

    URL die is gekoppeld aan het externe metagegevensobject.

Globale vlaggen

Voorbeelden

In het volgende voorbeeld wordt een extern metagegevensobject gemaakt voor een Snowflake-tabel:

databricks external-metadata create-external-metadata my_snowflake_table SNOWFLAKE TABLE --description "Production sales table" --url "https://example.snowflakecomputing.com/table/sales"

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

databricks external-metadata create-external-metadata tableau_dashboard TABLEAU DASHBOARD --json '{"description": "Sales dashboard", "owner": "user@example.com"}'

In het volgende voorbeeld wordt een extern metagegevensobject gemaakt met behulp van een JSON-bestand:

databricks external-metadata create-external-metadata bigquery_dataset GOOGLE_BIGQUERY DATASET --json @external-metadata.json

databricks external-metadata delete-external-metadata

Verwijder het externe metagegevensobject dat overeenkomt met de opgegeven naam. De aanroeper moet een metastore-beheerder, de eigenaar van het externe metagegevensobject of een gebruiker met de bevoegdheid BEHEREN zijn.

databricks external-metadata delete-external-metadata NAME [flags]

Arguments

NAME

    Naam van het externe metagegevensobject dat moet worden verwijderd.

Opties

Globale vlaggen

Voorbeelden

In het volgende voorbeeld wordt een extern metagegevensobject verwijderd:

databricks external-metadata delete-external-metadata my_snowflake_table

databricks external-metadata get-external-metadata

Haal het opgegeven externe metagegevensobject op in een metastore. De aanroeper moet een metastore-beheerder, de eigenaar van het externe metagegevensobject of een gebruiker met de bevoegdheid BROWSE zijn.

databricks external-metadata get-external-metadata NAME [flags]

Arguments

NAME

    Naam van het externe metagegevensobject dat moet worden opgehaald.

Opties

Globale vlaggen

Voorbeelden

In het volgende voorbeeld wordt een extern metagegevensobject opgehaald:

databricks external-metadata get-external-metadata my_snowflake_table

databricks external-metadata list-external-metadata

Lijst met externe metagegevensobjecten in de metastore. Als de aanroeper de metastore-beheerder is, worden alle externe metagegevensobjecten opgehaald. Anders worden alleen externe metagegevensobjecten waarvoor de aanroeper BROWSE heeft, opgehaald. Er is geen garantie voor een specifieke volgorde van de elementen in de matrix.

databricks external-metadata list-external-metadata [flags]

Opties

--page-size int

    Maximum aantal externe metagegevensobjecten dat per pagina moet worden geretourneerd.

--page-token string

    Token om de volgende pagina met resultaten op te halen.

Globale vlaggen

Voorbeelden

In het volgende voorbeeld ziet u alle externe metagegevensobjecten:

databricks external-metadata list-external-metadata

In het volgende voorbeeld ziet u een lijst met externe metagegevensobjecten met paginering:

databricks external-metadata list-external-metadata --page-size 10

databricks external-metadata update-external-metadata

Werk het externe metagegevensobject bij dat overeenkomt met de opgegeven naam. De aanroeper kan alleen de eigenaar- of andere metagegevensvelden in één aanvraag bijwerken. De aanroeper moet een metastore-beheerder, de eigenaar van het externe metagegevensobject of een gebruiker met de bevoegdheid MODIFY zijn. Als de beller de eigenaar bijwerkt, moet deze ook de bevoegdheid BEHEREN hebben.

databricks external-metadata update-external-metadata NAME UPDATE_MASK SYSTEM_TYPE ENTITY_TYPE [flags]

Arguments

NAME

    Naam van het externe metagegevensobject.

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.

SYSTEM_TYPE

    Type extern systeem. Ondersteunde waarden: AMAZON_REDSHIFT, AZURE_SYNAPSE, CONFLUENT, , DATABRICKS, GOOGLE_BIGQUERY, KAFKA, MICROSOFT_FABRICLOOKER, , , MICROSOFT_SQL_SERVER, MONGODB, OTHERSAPMYSQLORACLEPOSTGRESQLPOWER_BISALESFORCESERVICENOWSNOWFLAKESTREAM_NATIVETABLEAUTERADATAWORKDAY

ENTITY_TYPE

    Type entiteit binnen het externe systeem.

Opties

--description string

    Vrije tekstbeschrijving door gebruiker verstrekt.

--json JSON

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

--owner string

    Eigenaar van het externe metagegevensobject.

--url string

    URL die is gekoppeld aan het externe metagegevensobject.

Globale vlaggen

Voorbeelden

In het volgende voorbeeld wordt de beschrijving van een extern metagegevensobject bijgewerkt:

databricks external-metadata update-external-metadata my_snowflake_table "description" SNOWFLAKE TABLE --description "Updated production sales table"

In het volgende voorbeeld wordt de eigenaar van een extern metagegevensobject bijgewerkt:

databricks external-metadata update-external-metadata my_snowflake_table "owner" SNOWFLAKE TABLE --owner "newowner@example.com"

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

databricks external-metadata update-external-metadata my_snowflake_table "description,url" SNOWFLAKE TABLE --json '{"description": "Latest sales data", "url": "https://example.snowflakecomputing.com/table/sales_v2"}'

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