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>