Naslaginformatie voor Databricks SQL-API

Belangrijk

Deze functie is beschikbaar als openbare preview.

De Databricks SQL REST API ondersteunt services voor het beheren van query's en dashboards, querygeschiedenis en SQL eindpunten.

In dit artikel wordt uitgelegd hoe u de REST API gebruikt. Aan het einde van het artikel vindt u links naar elke API-naslag.

Zie Verificatie met behulp van Azure Databricks persoonlijke toegangstokens in Databricks voor meer informatie over verificatie bij de REST API met behulp van SQL persoonlijke toegangstokens.

Zie Verifiëren met Azure Active Directory-tokens voor informatie over het verifiëren van de REST API met behulp van Azure Active Directory-tokens. Zie voor voorbeelden Een Azure Active Directory-toegangstoken gebruiken voor een gebruiker en Een Azure Active Directory-toegangstoken gebruiken voor een service-principal.

Frequentielimieten

De Databricks REST API ondersteunt maximaal 30 aanvragen/seconde per werkruimte. Aanvragen die de frequentielimiet overschrijden, ontvangen een 429-statuscode.

Uitvoer parseren

Het kan nuttig zijn om delen van de JSON-uitvoer te parseren. In deze gevallen raden we u aan het hulpprogramma jq te gebruiken. Raadpleeg voor meer informatie de jq-gebruikershandleiding. U kunt jq op MacOS installeren met behulp van Homebrew door brew install jq uit te voeren.

Sommige velden (die foutberichten en beschrijvende berichten bevatten die zijn bedoeld om te worden gebruikt door de gebruikersinterface) zijn ongestructureerd en u mag niet afhankelijk zijn van de indeling van deze velden STRING in programmatische werkstromen.

Een GET-bewerking aanroepen met een queryreeks

Hoewel de meeste API-aanroepen vereisen dat u een JSON-body opgeeft, kunt u voor aanroepen het object opgeven dat GET moet worden opgehaald. Voer bijvoorbeeld het volgende uit om de details voor een SQL op te halen:

curl ... https://<databricks-instance>/api/2.0/sql/endpoints/<endpoint-id>

Verifiëren bij Databricks SQL API's

Databricks SQL API's