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>

API's