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.
Note
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 external-locations i Databricks CLI innehåller kommandon för att skapa och hantera externa platser för Unity Catalog. Se Vad är Unity Catalog-volymer?.
databricks externa-platser skapa
Skapa en ny anteckning för extern plats i metastore. Anroparen måste vara metaarkivadministratör eller ha behörighet för CREATE_EXTERNAL_LOCATION både metaarkivet och tillhörande lagringsautentiseringsuppgifter.
databricks external-locations create NAME URL CREDENTIAL_NAME [flags]
Arguments
NAME
Namnet på den externa platsen.
URL
Sökvägs-URL för den externa platsen.
CREDENTIAL_NAME
Namnet på lagringsautentiseringsuppgifterna som används med den här platsen.
Options
--comment string
Beskrivning av text i fritt formulär som tillhandahålls av användaren.
--enable-file-events
Om du vill aktivera filhändelser på den här externa platsen.
--fallback
Anger om återställningsläget är aktiverat för den här externa platsen.
--json JSON
Den infogade JSON-strängen @path eller till JSON-filen med begärandetexten.
--read-only
Anger huruvida den externa platsen är skrivskyddad.
--skip-validation
Hoppar över valideringen av lagringsautentiseringsuppgifterna som är associerade med den externa platsen.
Examples
I följande exempel skapas en extern plats med en kommentar:
databricks external-locations create my-external-location s3://my-bucket/path my-credential --comment "External location for data lake"
I följande exempel skapas en skrivskyddad extern plats:
databricks external-locations create my-external-location s3://my-bucket/path my-credential --read-only
databricks externa platser radera
Ta bort den angivna externa platsen från metaarkivet. Anroparen måste vara ägare till den externa platsen.
databricks external-locations delete NAME [flags]
Arguments
NAME
Namnet på den externa platsen.
Options
--force
Framtvinga borttagning även om det finns beroende externa tabeller eller monteringar.
Examples
I det följande exemplet raderas en extern plats med namnet my-external-location:
databricks external-locations delete my-external-location
I följande exempel tas en extern plats bort med kraft även om det finns beroenden:
databricks external-locations delete my-external-location --force
databricks externa lagringsplatser hämta
Hämta en extern plats från metaarkivet. Anroparen måste vara antingen metaarkivadministratör, ägare till den externa platsen eller en användare som har viss behörighet på den externa platsen.
databricks external-locations get NAME [flags]
Arguments
NAME
Namnet på den externa platsen.
Options
--include-browse
Huruvida man ska inkludera externa platser i svaret för vilka den huvudansvarige endast kan komma åt selektiv metadata.
Examples
I följande exempel hämtas information om en extern plats med namnet my-external-location:
databricks external-locations get my-external-location
I följande exempel hämtas information, inklusive bläddringsmetadata:
databricks external-locations get my-external-location --include-browse
lista över externa databricks-platser
Lista externa platser från ”metastore”. Anroparen måste vara metaarkivadministratör, ägare till den externa platsen eller en användare som har viss behörighet på den externa platsen. Det finns ingen garanti för en specifik ordning på elementen i matrisen.
databricks external-locations list [flags]
Options
--include-browse
Huruvida man ska inkludera externa platser i svaret för vilka den huvudansvarige endast kan komma åt selektiv metadata.
--include-unbound
Om du vill inkludera externa platser som inte är bundna till arbetsytan.
--max-results int
Maximalt antal externa platser som ska returneras.
--page-token string
Ogenomskinlig sidnumreringstoken för att gå till nästa sida baserat på föregående fråga.
Examples
I följande exempel visas alla externa platser:
databricks external-locations list
I följande exempel visas externa platser med högst 10 resultat:
databricks external-locations list --max-results 10
uppdatering av externa databricks-platser
Uppdatera en extern plats i metaarkivet. Anroparen måste vara ägare till den externa platsen eller vara metaarkivadministratör. I det andra fallet kan administratören bara uppdatera namnet på den externa platsen.
databricks external-locations update NAME [flags]
Arguments
NAME
Namnet på den externa platsen.
Options
--comment string
Beskrivning av text i fritt formulär som tillhandahålls av användaren.
--credential-name string
Namnet på lagringsautentiseringsuppgifterna som används med den här platsen.
--enable-file-events
Om du vill aktivera filhändelser på den här externa platsen.
--fallback
Anger om återställningsläget är aktiverat för den här externa platsen.
--force
Framtvinga uppdatering även om en ändring av URL:en ogiltigförklarar beroende externa tabeller eller monteringar.
--isolation-mode IsolationMode
Värden som stöds: ISOLATION_MODE_ISOLATED, ISOLATION_MODE_OPEN
--json JSON
Den infogade JSON-strängen @path eller till JSON-filen med begärandetexten.
--new-name string
Nytt namn på den externa platsen.
--owner string
Ägaren till den externa platsen.
--read-only
Anger huruvida den externa platsen är skrivskyddad.
--skip-validation
Hoppar över valideringen av lagringsautentiseringsuppgifterna som är associerade med den externa platsen.
--url string
Sökvägs-URL för den externa platsen.
Examples
Följande exempel visar hur en extern lokation byts namn:
databricks external-locations update my-external-location --new-name my-renamed-location
I följande exempel ändras ägaren till en extern plats:
databricks external-locations update my-external-location --owner someone@example.com
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 eller textjson. 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 filen som ~/.databrickscfg 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