API-referens för SQL-analys

Viktigt

Den här funktionen finns som allmänt tillgänglig förhandsversion. Kontakta din Databricks-representant om du vill begära åtkomst.

REST-API för SQL-analys i Databricks stöder tjänster för att hantera dina SQL-slutpunkter och din frågehistorik.

Den här artikeln innehåller en översikt över hur du använder REST API. Länkar till varje API-referens visas i slutet av artikeln.

Information om hur du autentiserar till REST API med personlig åtkomsttoken finns i Autentisering med personlig åtkomsttoken i Azure Databricks.

Information om hur du autentiserar till REST API med Azure Active Directory-token finns i Autentisering med Azure Active Directory-token. Exempel finns i Använda en Azure AD-åtkomsttoken för en användare och Använda en Azure AD-åtkomsttoken för ett huvudnamn för tjänsten.

Hastighetsbegränsningar

Databricks REST API stöder maximalt 30 förfrågningar per sekund per arbetsyta. Förfrågningar som överskrider hastighetsgränsen får svarsstatuskod 429.

Parsa utdata

Det kan vara användbart att analysera (parsa) delar av JSON-utdata. I de här fallen rekommenderar vi att du använder verktyget jq. Mer information finns i användarhandboken till jq. Du kan installera jq på MacOS med Homebrew genom att köra brew install jq.

Vissa STRING-fält (som innehåller fel/beskrivande meddelanden som är avsedda att användas av användargränssnittet) är ostrukturerade och du bör inte vara beroende av formatet på dessa fält i programmässiga arbetsflöden.

Anropa en GET med en frågesträng

De flesta API-anrop kräver att du anger en JSON-text, men för GET-anrop kan du ange en frågesträng.

Om du vill ha mer information om en SQL-slutpunkt kör du:

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

API:er