Api-referens för Databricks SQL
Viktigt
Den här funktionen finns som allmänt tillgänglig förhandsversion.
Databricks-SQL REST API tjänster för att hantera frågor och instrumentpaneler, frågehistorik och SQL slutpunkter.
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 personliga åtkomsttoken finns i Autentisering med Azure Databricks personliga åtkomsttoken i Databricks SQL.
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 fält (som innehåller fel och beskrivande meddelanden som är avsedda att användas av användargränssnittet) är ostrukturerade och du bör inte vara beroende av formatet för dessa fält i STRING programmässiga arbetsflöden.
Anropa en GET med en frågesträng
De flesta API-anrop kräver att du anger en JSON-brödtext, men för GET anrop kan du ange vilket objekt som ska hämtas. Om du till exempel vill hämta information om SQL slutpunkt kör du:
curl ... https://<databricks-instance>/api/2.0/sql/endpoints/<endpoint-id>