Referenční informace k SQL API služby Databricks
Důležité
Tato funkce je ve verzi Public Preview.
Databricks podporuje SQL REST API pro správu dotazů a řídicích panelů, historii dotazů a SQL koncových bodů.
Tento článek obsahuje přehled použití tohoto rozhraní REST API. Odkazy na referenční informace k jednotlivým rozhraním API jsou uvedené na konci článku.
Informace o ověřování v REST API tokeny najdete v tématu Ověřování pomocí tokenů AZURE DATABRICKS v Databricks SQL.
Informace o ověřování v rozhraní REST API pomocí tokenů Azure Active Directory najdete v tématu Ověřování pomocí tokenů Azure Active Directory. Příklady najdete v částech Použití přístupového tokenu Azure AD pro uživatele a Použití přístupového tokenu Azure AD pro instanční objekt.
Omezení přenosové rychlosti
Rozhraní Databricks REST API podporuje maximálně 30 požadavků za sekundu na jeden pracovní prostor. Požadavky, které toto omezení přenosové rychlosti překročí, obdrží stavový kód odpovědi 429.
Parsování výstupu
Někdy může být užitečné parsováním získat části výstupu JSON. V takových případech doporučujeme použít nástroj jq. Další informace najdete v příručce k nástroji jq. V systému MacOS můžete nástroj jq nainstalovat pomocí Homebrew spuštěním příkazu brew install jq.
Některá pole (která obsahují chybové a popisné zprávy určené k používání uživatelským rozhraním) jsou nestrukturovaná a neměla by záviset na formátu těchto polí v programových pracovních STRING postupech.
Vyvolání příkazu GET pomocí řetězce dotazu
I když většina volání rozhraní API vyžaduje zadání textu JSON, pro volání můžete GET zadat objekt, který se má načíst. Pokud například chcete získat podrobnosti o koncovém SQL, spusťte:
curl ... https://<databricks-instance>/api/2.0/sql/endpoints/<endpoint-id>