Databricks SQL API-referencia

Fontos

Ez a funkció a nyilvános előzetes verzióban érhető el.

A Databricks SQL REST API a lekérdezések és irányítópultok, lekérdezéselőzmények és végpontok kezeléséhez SQL szolgáltatásokat.

Ebben a cikkben a REST API-k használatának az áttekintését olvashatja el. Az API-hivatkozások listája a cikk végén található.

További információ a REST API való hitelesítésről: Hitelesítés Azure Databricks személyes hozzáférési jogkivonatokkal a Databricks SQL.

Az Azure Active Directory-jogkivonatokkal a REST API-kon keresztül végzett hitelesítésről az Azure Active Directory-jogkivonatok használatával történő hitelesítésről szóló cikkben talál további információt. Példákért tekintse meg az Azure AD hozzáférési jogkivonat felhasználóval való használatát és az Azure AD hozzáférési jogkivonat szolgáltatásnévvel való használatát ismertető cikkeket.

Sebességkorlátok

A Databricks REST API-ja maximum 30 kérés/másodperces sebességet támogat munkaterületenként. A rendszer a 429-es válasz állapotkódjával látja el azokat a kéréseket, amelyek túllépik a sebességhatárt.

Kimenet elemzése

Bizonyos esetekben hasznos lehet a JSON-kimenet részeinek elemzése. Ezekben az esetekben a jq segédprogram alkalmazását ajánljuk. További információért tekintse meg a jq-kézikönyvet. A jq MacOS-en a Homebrew használatával, az brew install jq parancs futtatásával telepíthető.

Egyes mezők (amelyek a felhasználói felület által használni kívánt hiba- és leíró üzenetkezelést tartalmaznak) strukturálatlanok, és nem szabad függni ezeknek a mezőknek a formátumától a programozott STRING munkafolyamatokban.

GET meghívása egy lekérdezési karakterlánccal

Bár a legtöbb API-híváshoz meg kell adnia egy JSON-törzset, a hívásokhoz megadhatja a lekérni kívánt GET objektumot. Egy új végpont részleteinek le SQL futtassa a következőt:

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

Hitelesítés a Databricksben SQL API-kban

Databricks SQL API-k