Naslaginformatie over de SQL Analytics-API
Belangrijk
Deze functie is beschikbaar als openbare preview. Neem contact op met uw accountmanager van Azure Databricks om toegang te vragen.
De REST-API van Databricks SQL Analytics ondersteunt services voor het beheren van uw SQL-eindpunten en querygeschiedenis.
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 persoonlijke toegangstokens van Azure Databricksvoor meer informatie over de verificatie in de REST API met persoonlijk 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 STRING-velden (met foutberichten/beschrijvende berichten die zijn bedoeld om te worden gebruikt door de UI) zijn niet gestructureerd. Gebruik de indeling van deze velden niet in programmatische werkstromen.
Een GET-bewerking aanroepen met een queryreeks
Hoewel de meeste API-aanroepen vereisen dat u een JSON-hoofdtekst opgeeft, kunt u voor GET-aanroepen een queryreeks opgeven.
Voer het volgende uit om de details van een SQL-eindpunt op te halen:
curl ... https://<databricks-instance>/api/2.0/sql/endpoints/get?id=<endpoint-id>