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>