Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Note
Deze informatie is van toepassing op Databricks CLI-versies 0.205 en hoger. De Databricks CLI bevindt zich in openbare preview.
Databricks CLI-gebruik is onderhevig aan de Databricks-licentie en de privacyverklaring van Databricks, met inbegrip van alle bepalingen voor gebruiksgegevens.
Met warehouses de opdrachtgroep in de Databricks CLI kunt u SQL-warehouses beheren. Een SQL Warehouse is een rekenresource waarmee u SQL-opdrachten kunt uitvoeren op gegevensobjecten in Databricks SQL. Zie Verbinding maken met een SQL-warehouse.
Databricks-magazijnen maken
Maak een nieuw SQL-warehouse.
databricks warehouses create [flags]
Arguments
None
Options
--auto-stop-mins int
De hoeveelheid tijd in minuten dat een SQL Warehouse inactief moet zijn (met andere woorden, geen RUNNING query's) voordat deze automatisch wordt gestopt.
--cluster-size string
Grootte van de clusters die zijn toegewezen voor dit magazijn.
--creator-name string
Naam van de maker van het magazijn.
--enable-photon
Hiermee configureert u of het magazijn gebruikmaakt van door Photon geoptimaliseerde clusters.
--enable-serverless-compute
Hiermee configureert u of het magazijn serverloze rekenkracht moet gebruiken.
--instance-profile-arn string
Deprecated.
--json JSON
De inline JSON-tekenreeks of het @path naar het JSON-bestand met de hoofdtekst van de aanvraag.
--max-num-clusters int
Maximum aantal clusters dat door de automatische schaalaanpassing wordt gemaakt om gelijktijdige query's te verwerken.
--min-num-clusters int
Minimaal aantal beschikbare clusters dat wordt onderhouden voor dit SQL-warehouse.
--name string
Logische naam voor het cluster.
--no-wait
Wacht niet om de status RUNNING te bereiken
--spot-instance-policy SpotInstancePolicy
Configuraties van of het magazijn spot-instances moet gebruiken of niet. Ondersteunde waarden: COST_OPTIMIZED, POLICY_UNSPECIFIED, RELIABILITY_OPTIMIZED
--timeout duration
Maximale tijdsduur om de status te bereiken RUNNING (standaard 20 ms)
--warehouse-type CreateWarehouseRequestWarehouseType
Magazijntype: PRO of CLASSIC. Ondersteunde waarden: CLASSIC, PRO, TYPE_UNSPECIFIED
Examples
In het volgende voorbeeld wordt een nieuw SQL Warehouse gemaakt met basisconfiguratie:
databricks warehouses create --name "my-warehouse" --cluster-size "Small" --min-num-clusters 1 --max-num-clusters 10 --auto-stop-mins 60
In het volgende voorbeeld wordt een serverloze magazijn gemaakt waarvoor Photon is ingeschakeld:
databricks warehouses create --name "serverless-warehouse" --enable-serverless-compute --enable-photon --warehouse-type PRO
databricks-warehouses maken-default-warehouse-override
Maak een standaard-magazijnoverschrijving voor een gebruiker. Gebruikers kunnen hun eigen onderdrukking maken. Beheerders kunnen onderdrukkingen maken voor elke gebruiker.
databricks warehouses create-default-warehouse-override DEFAULT_WAREHOUSE_OVERRIDE_ID TYPE [flags]
Arguments
DEFAULT_WAREHOUSE_OVERRIDE_ID
De id voor de onderdrukking. Gebruik een numerieke gebruikers-id of de letterlijke tekenreeks me voor de huidige gebruiker.
TYPE
Het type onderdrukkingsgedrag. Ondersteunde waarden: CUSTOM, LAST_SELECTED.
Options
--json JSON
De inline JSON-tekenreeks of het @path naar het JSON-bestand met de hoofdtekst van de aanvraag.
--name string
De resourcenaam van de standaardwarehouse-onderdrukking.
--warehouse-id string
De specifieke magazijn-id wanneer het type is CUSTOM.
Examples
In het volgende voorbeeld wordt een aangepaste magazijnoverschrijving gemaakt voor de huidige gebruiker:
databricks warehouses create-default-warehouse-override me CUSTOM --warehouse-id 1234567890abcdef
Databricks-magazijnen verwijderen
Een SQL Warehouse verwijderen.
databricks warehouses delete ID [flags]
Arguments
ID
Required. Id van het SQL-warehouse.
Options
Examples
In het volgende voorbeeld wordt een magazijn met de opgegeven id verwijderd:
databricks warehouses delete 1234567890abcdef
databricks-warehouses verwijderen-default-warehouse-override
Verwijder de standaard-magazijnoverschrijving voor een gebruiker. Gebruikers kunnen hun eigen onderdrukking verwijderen. Beheerders kunnen onderdrukkingen voor elke gebruiker verwijderen. Na verwijdering wordt het standaardwarehouse van de werkruimte gebruikt.
databricks warehouses delete-default-warehouse-override NAME [flags]
Arguments
NAME
De resourcenaam van de standaardwarehouse-onderdrukking die u wilt verwijderen. Indeling: default-warehouse-overrides/{default_warehouse_override_id}. De id kan een numerieke gebruikers-id of de letterlijke tekenreeks me voor de huidige gebruiker zijn.
Options
Examples
In het volgende voorbeeld wordt de standaard-magazijnoverschrijving voor de huidige gebruiker verwijderd:
databricks warehouses delete-default-warehouse-override default-warehouse-overrides/me
Databricks-magazijnen bewerken
Een magazijn bijwerken. Hiermee wordt de configuratie voor een SQL-warehouse bijgewerkt.
databricks warehouses edit ID [flags]
Arguments
ID
Required. Id van het magazijn dat moet worden geconfigureerd.
Options
--auto-stop-mins int
De hoeveelheid tijd in minuten dat een SQL Warehouse inactief moet zijn (met andere woorden, geen RUNNING query's) voordat deze automatisch wordt gestopt.
--cluster-size string
Grootte van de clusters die zijn toegewezen voor dit magazijn.
--creator-name string
Naam van de maker van het magazijn.
--enable-photon
Hiermee configureert u of het magazijn gebruikmaakt van door Photon geoptimaliseerde clusters.
--enable-serverless-compute
Hiermee configureert u of het magazijn serverloze rekenkracht moet gebruiken.
--instance-profile-arn string
Deprecated.
--json JSON
De inline JSON-tekenreeks of het @path naar het JSON-bestand met de hoofdtekst van de aanvraag.
--max-num-clusters int
Maximum aantal clusters dat door de automatische schaalaanpassing wordt gemaakt om gelijktijdige query's te verwerken.
--min-num-clusters int
Minimaal aantal beschikbare clusters dat wordt onderhouden voor dit SQL-warehouse.
--name string
Logische naam voor het cluster.
--no-wait
Wacht niet tot de status RUNNING is bereikt
--spot-instance-policy SpotInstancePolicy
Configuraties van of het magazijn spot-instances moet gebruiken of niet. Ondersteunde waarden: COST_OPTIMIZED, POLICY_UNSPECIFIED, RELIABILITY_OPTIMIZED
--timeout duration
Maximale tijdsduur om de status te bereiken RUNNING (standaard 20 ms)
--warehouse-type EditWarehouseRequestWarehouseType
Magazijntype. Ondersteunde waarden: CLASSIC, PRO, TYPE_UNSPECIFIED
Examples
In het volgende voorbeeld wordt een magazijn bijgewerkt om de clustergrootte en de automatische stoptijd te wijzigen:
databricks warehouses edit 1234567890abcdef --cluster-size "Medium" --auto-stop-mins 30
In het volgende voorbeeld wordt Photon ingeschakeld voor een bestaand magazijn:
databricks warehouses edit 1234567890abcdef --enable-photon
databricks-magazijnen verkrijgen
Haal de informatie op voor één SQL-warehouse.
databricks warehouses get ID [flags]
Arguments
ID
Required. Id van het SQL-warehouse.
Options
Examples
In het volgende voorbeeld wordt informatie opgehaald over een magazijn met de opgegeven id:
databricks warehouses get 1234567890abcdef
databricks-magazijnen krijgen standaard-warehouse-onderdrukking
De standaard-warehouse-onderdrukking voor een gebruiker ophalen. Gebruikers kunnen hun eigen onderdrukking ophalen. Beheerders kunnen onderdrukkingen voor elke gebruiker ophalen. Als er geen onderdrukking bestaat, wordt het standaardwarehouse van de werkruimte gebruikt.
databricks warehouses get-default-warehouse-override NAME [flags]
Arguments
NAME
De resourcenaam van de standaardwarehouse-onderdrukking die moet worden opgehaald. Indeling: default-warehouse-overrides/{default_warehouse_override_id}. De id kan een numerieke gebruikers-id of de letterlijke tekenreeks me voor de huidige gebruiker zijn.
Options
Examples
In het volgende voorbeeld wordt de standaard-warehouse-onderdrukking voor de huidige gebruiker weergegeven:
databricks warehouses get-default-warehouse-override default-warehouse-overrides/me
databricks-warehouses get-workspace-warehouse-config
Haal de configuratie op werkruimteniveau op die wordt gedeeld door alle SQL-warehouses in een werkruimte.
databricks warehouses get-workspace-warehouse-config [flags]
Arguments
None
Options
Examples
In het volgende voorbeeld wordt de configuratie van het werkruimtewarehouse ophaalt:
databricks warehouses get-workspace-warehouse-config
Lijst met databricks-magazijnen
Geef een lijst weer van alle SQL-warehouses waarvoor een gebruiker machtigingen voor beheer heeft.
databricks warehouses list [flags]
Arguments
None
Options
--run-as-user-id int
Service Principal die wordt gebruikt om de lijst met magazijnen op te halen.
Examples
In het volgende voorbeeld worden alle magazijnen weergegeven:
databricks warehouses list
In het volgende voorbeeld ziet u een lijst met magazijnen met behulp van een specifieke service-principal:
databricks warehouses list --run-as-user-id 123456789
databricks warehouses list-default-warehouse-overrides
Alle standaardwarehouse-onderdrukkingen in de werkruimte weergeven. Alleen werkruimtebeheerders kunnen alle onderdrukkingen vermelden.
databricks warehouses list-default-warehouse-overrides [flags]
Options
--page-size int
Het maximum aantal onderdrukkingen dat moet worden geretourneerd.
--page-token string
Een paginatoken dat is ontvangen van een vorige list-default-warehouse-overrides aanroep.
Examples
In het volgende voorbeeld worden alle standaard-magazijnoverschrijvingen vermeld:
databricks warehouses list-default-warehouse-overrides
databricks-warehouses set-workspace-warehouse-config
Stel de configuratie op werkruimteniveau in die wordt gedeeld door alle SQL-warehouses in een werkruimte.
databricks warehouses set-workspace-warehouse-config [flags]
Arguments
None
Options
--google-service-account string
Alleen GCP: Google-serviceaccount dat wordt gebruikt om door te geven aan het cluster voor toegang tot Google Cloud Storage.
--instance-profile-arn string
Alleen AWS: Instanceprofiel dat wordt gebruikt om een IAM-rol aan het cluster door te geven.
--json JSON
De inline JSON-tekenreeks of het @path naar het JSON-bestand met de hoofdtekst van de aanvraag.
--security-policy SetWorkspaceWarehouseConfigRequestSecurityPolicy
Beveiligingsbeleid voor magazijnen. Ondersteunde waarden: DATA_ACCESS_CONTROL, NONE, PASSTHROUGH
Examples
In het volgende voorbeeld wordt de configuratie van het werkruimtewarehouse ingesteld met een beveiligingsbeleid:
databricks warehouses set-workspace-warehouse-config --security-policy DATA_ACCESS_CONTROL
databricks-magazijnen starten
Start een SQL-warehouse.
databricks warehouses start ID [flags]
Arguments
ID
Required. Id van het SQL-warehouse.
Options
--no-wait
Wacht niet tot de status RUNNING is bereikt
--timeout duration
Maximale tijdsduur om de status te bereiken RUNNING (standaard 20 ms)
Examples
In het volgende voorbeeld wordt een magazijn gestart met de opgegeven id:
databricks warehouses start 1234567890abcdef
In het volgende voorbeeld wordt een magazijn gestart zonder te wachten tot deze de status bereikt RUNNING :
databricks warehouses start 1234567890abcdef --no-wait
databricks-magazijnen worden stopgezet
Stop een SQL-warehouse.
databricks warehouses stop ID [flags]
Arguments
ID
Required. Id van het SQL-warehouse.
Options
--no-wait
Wacht niet tot de status STOPPED is bereikt
--timeout duration
Maximale tijdsduur om de status te bereiken STOPPED (standaard 20 ms)
Examples
In het volgende voorbeeld wordt een magazijn met de opgegeven id gestopt:
databricks warehouses stop 1234567890abcdef
In het volgende voorbeeld wordt een magazijn gestopt zonder te wachten tot deze de status bereikt STOPPED :
databricks warehouses stop 1234567890abcdef --no-wait
databricks-warehouses update-default-warehouse-override
Een bestaande standaardwarehouse-onderdrukking voor een gebruiker bijwerken. Gebruikers kunnen hun eigen onderdrukking bijwerken. Beheerders kunnen onderdrukkingen voor elke gebruiker bijwerken.
databricks warehouses update-default-warehouse-override NAME UPDATE_MASK TYPE [flags]
Arguments
NAME
De resourcenaam van de standaardwarehouse-onderdrukking. Indeling: default-warehouse-overrides/{default_warehouse_override_id}.
UPDATE_MASK
Veldmasker waarmee wordt opgegeven welke velden moeten worden bijgewerkt. Gebruik * deze functie om alle velden bij te werken. Wanneer --allow-missing dit veld is ingesteld, wordt dit veld genegeerd en worden alle velden toegepast.
TYPE
Het type onderdrukkingsgedrag. Ondersteunde waarden: CUSTOM, LAST_SELECTED.
Options
--allow-missing
Als deze optie is ingesteld en de onderdrukking niet wordt gevonden, maakt u in plaats daarvan een nieuwe overschrijving.
--json JSON
De inline JSON-tekenreeks of het @path naar het JSON-bestand met de hoofdtekst van de aanvraag.
--name string
De resourcenaam van de standaardwarehouse-onderdrukking.
--warehouse-id string
De specifieke magazijn-id wanneer het type is CUSTOM.
Examples
In het volgende voorbeeld wordt de onderdrukking van de huidige gebruiker bijgewerkt naar een specifiek magazijn:
databricks warehouses update-default-warehouse-override default-warehouse-overrides/me warehouse_id CUSTOM --warehouse-id 1234567890abcdef
databricks-warehouses krijgen machtigingsniveaus
Machtigingsniveaus voor SQL Warehouse ophalen.
databricks warehouses get-permission-levels WAREHOUSE_ID [flags]
Arguments
WAREHOUSE_ID
Het SQL Warehouse waarvoor u machtigingen wilt ophalen of beheren.
Options
Examples
In het volgende voorbeeld worden de machtigingsniveaus voor een magazijn opgehaald.
databricks warehouses get-permission-levels 1234567890abcdef
get-permissions voor databricks-warehouses
Haal de machtigingen van een SQL Warehouse op. SQL Warehouses kunnen machtigingen overnemen van hun hoofdobject.
databricks warehouses get-permissions WAREHOUSE_ID [flags]
Arguments
WAREHOUSE_ID
Het SQL Warehouse waarvoor u machtigingen wilt ophalen of beheren.
Options
Examples
In het volgende voorbeeld worden de machtigingen voor een magazijn opgehaald.
databricks warehouses get-permissions 1234567890abcdef
Machtigingen instellen voor Databricks-warehouses
Sql Warehouse-machtigingen instellen. Hiermee stelt u machtigingen in voor een object, waarbij bestaande machtigingen worden vervangen als deze bestaan. Hiermee verwijdert u alle directe machtigingen als er geen machtigingen zijn opgegeven. Objecten kunnen machtigingen overnemen van hun hoofdobject.
databricks warehouses set-permissions WAREHOUSE_ID [flags]
Arguments
WAREHOUSE_ID
Het SQL Warehouse waarvoor u machtigingen wilt ophalen of beheren.
Options
--json JSON
De inline JSON-tekenreeks of het @path naar het JSON-bestand met de hoofdtekst van de aanvraag.
Examples
In het volgende voorbeeld worden machtigingen ingesteld voor een magazijn met behulp van een JSON-bestand:
databricks warehouses set-permissions 1234567890abcdef --json @permissions.json
updatemachtigingen voor databricks-warehouses
Werk de machtigingen voor een SQL Warehouse bij. SQL Warehouses kunnen machtigingen overnemen van hun hoofdobject.
databricks warehouses update-permissions WAREHOUSE_ID [flags]
Arguments
WAREHOUSE_ID
Het SQL Warehouse waarvoor u machtigingen wilt ophalen of beheren.
Options
--json JSON
De inline JSON-tekenreeks of het @path naar het JSON-bestand met de hoofdtekst van de aanvraag.
Examples
In het volgende voorbeeld worden machtigingen voor een magazijn bijgewerkt met behulp van een JSON-bestand:
databricks warehouses update-permissions 1234567890abcdef --json @permissions.json
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