external-locations opdrachtgroep

De external-locations opdrachtgroep in de Databricks CLI bevat opdrachten voor het maken en beheren van externe locaties voor Unity Catalog. Zie Wat zijn Unity Catalog-volumes?

externe databricks-locaties maken

Maak een nieuwe vermelding voor een externe locatie in de metastore. De aanroeper moet een metastore-beheerder zijn of de CREATE_EXTERNAL_LOCATION bevoegdheid hebben voor zowel de metastore als de bijbehorende opslagreferentie.

databricks external-locations create NAME URL CREDENTIAL_NAME [flags]

Arguments

NAME

    Naam van de externe locatie.

URL

    Pad-URL van de externe locatie.

CREDENTIAL_NAME

    De naam van de opslagreferentie die bij deze locatie wordt gebruikt.

Options

--comment string

    Vrije tekstbeschrijving door gebruiker verstrekt.

--enable-file-events

    Hiermee wordt aangegeven of bestandsevenementen op deze externe locatie moeten worden ingeschakeld.

--fallback

    Geeft aan of de terugvalmodus is ingeschakeld voor deze externe locatie.

--json JSON

    De inline JSON-tekenreeks of het @path naar het JSON-bestand met de hoofdtekst van de aanvraag.

--read-only

    Geeft aan of de externe locatie het kenmerk Alleen-lezen heeft.

--skip-validation

    Hiermee wordt de validatie overgeslagen van de opslagreferentie die is gekoppeld aan de externe locatie.

Globale vlaggen

Examples

In het volgende voorbeeld wordt een externe locatie met een opmerking gemaakt:

databricks external-locations create my-external-location s3://my-bucket/path my-credential --comment "External location for data lake"

In het volgende voorbeeld wordt een alleen-lezen locatie voor externe opslag gemaakt:

databricks external-locations create my-external-location s3://my-bucket/path my-credential --read-only

externe locaties van Databricks verwijderen

Verwijder de opgegeven externe locatie uit de metastore. De beller moet de eigenaar van de externe locatie zijn.

databricks external-locations delete NAME [flags]

Arguments

NAME

    Naam van de externe locatie.

Options

--force

    Verwijdering afdwingen, zelfs als er afhankelijke externe tabellen of koppels zijn.

Globale vlaggen

Examples

In het volgende voorbeeld wordt een externe locatie met de naam verwijderd my-external-location:

databricks external-locations delete my-external-location

In het volgende voorbeeld wordt een externe locatie geforceerd verwijderd, zelfs als er afhankelijkheden zijn:

databricks external-locations delete my-external-location --force

Databricks-externe locaties ophalen

Haal een externe locatie op uit de metastore. De beller moet een metastore-beheerder, de eigenaar van de externe locatie of een gebruiker met enige bevoegdheden op de externe locatie zijn.

databricks external-locations get NAME [flags]

Arguments

NAME

    Naam van de externe locatie.

Options

--include-browse

    Of externe locaties moeten worden opgenomen in het antwoord waarvoor de principal alleen toegang heeft tot selectieve metagegevens.

Globale vlaggen

Examples

In het volgende voorbeeld wordt informatie opgehaald over een externe locatie met de naam my-external-location:

databricks external-locations get my-external-location

In het volgende voorbeeld wordt informatie opgehaald, waaronder browsemetagegevens:

databricks external-locations get my-external-location --include-browse

Externe locaties van Databricks weergeven.

Maak een lijst met externe locaties uit de metastore. De beller moet een metastore-beheerder, de eigenaar van de externe locatie of een gebruiker met enige bevoegdheden op de externe locatie zijn. Er is geen garantie voor een specifieke volgorde van de elementen in de matrix.

databricks external-locations list [flags]

Options

--include-browse

    Of externe locaties moeten worden opgenomen in het antwoord waarvoor de principal alleen toegang heeft tot selectieve metagegevens.

--include-unbound

    Of externe locaties niet aan de werkruimte zijn gebonden.

--max-results int

    Maximum aantal externe locaties dat moet worden geretourneerd.

--page-token string

    Ondoorzichtig pagineringstoken om naar de volgende pagina te gaan op basis van de vorige query.

Globale vlaggen

Examples

In het volgende voorbeeld ziet u alle externe locaties:

databricks external-locations list

In het volgende voorbeeld ziet u een lijst met externe locaties met maximaal 10 resultaten:

databricks external-locations list --max-results 10

Update van externe databricks-locaties

Werk een externe locatie in de metastore bij. De beller moet de eigenaar van de externe locatie zijn of een metastore-beheerder zijn. In het tweede geval kan de beheerder alleen de naam van de externe locatie bijwerken.

databricks external-locations update NAME [flags]

Arguments

NAME

    Naam van de externe locatie.

Options

--comment string

    Vrije tekstbeschrijving door gebruiker verstrekt.

--credential-name string

    De naam van de opslagreferentie die bij deze locatie wordt gebruikt.

--enable-file-events

    Hiermee wordt aangegeven of bestandsevenementen op deze externe locatie moeten worden ingeschakeld.

--fallback

    Geeft aan of de terugvalmodus is ingeschakeld voor deze externe locatie.

--force

    Forceer bijwerken, zelfs als het wijzigen van de URL afhankelijke externe tabellen of aankoppelingen ongeldig maakt.

--isolation-mode IsolationMode

    Ondersteunde waarden: ISOLATION_MODE_ISOLATED, ISOLATION_MODE_OPEN

--json JSON

    De inline JSON-tekenreeks of het @path naar het JSON-bestand met de hoofdtekst van de aanvraag.

--new-name string

    Nieuwe naam voor de externe locatie.

--owner string

    De eigenaar van de externe locatie.

--read-only

    Geeft aan of de externe locatie het kenmerk Alleen-lezen heeft.

--skip-validation

    Hiermee wordt de validatie overgeslagen van de opslagreferentie die is gekoppeld aan de externe locatie.

--url string

    Pad-URL van de externe locatie.

Globale vlaggen

Examples

In het volgende voorbeeld wordt de naam van een externe locatie gewijzigd:

databricks external-locations update my-external-location --new-name my-renamed-location

In het volgende voorbeeld wordt de eigenaar van een externe locatie gewijzigd:

databricks external-locations update my-external-location --owner someone@example.com

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 type logboekindeling of textjson. 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 uitvoertype van de opdracht of textjson. 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, 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