Konfigurace připojení k Databricks pomocí ovladače Databricks JDBC

Na této stránce se dozvíte, jak nakonfigurovat připojení k Databricks pomocí ovladače Databricks JDBC verze 3 a vyšší.

Konfigurace připojení

Pokud se chcete připojit ke svému pracovnímu prostoru Azure Databricks pomocí ovladače JDBC, musíte zadat nastavení připojení, včetně názvu hostitele serveru vašeho pracovního prostoru, nastavení výpočetních prostředků a přihlašovacích údajů pro ověřování.

Poznámka:

Ovladač JDBC nepodporuje připojení k Jobs Compute.

Nastavte tyto vlastnosti na adrese URL připojení JDBC, předejte je metodě DriverManager.getConnection nebo použijte kombinaci obou. Informace o tom, jak se nejlépe připojit pomocí konkrétní aplikace, klienta, sady SDK, rozhraní API nebo nástroje SQL, najdete v dokumentaci poskytovatele.

Adresa URL připojení JDBC musí být v následujícím formátu. Vlastnosti nerozlišují velikost písmen.

jdbc:databricks://<server-hostname>:<port>/<schema>;[property1]=[value];[property2]=[value];...

Případně můžete zadat nastavení pomocí třídy java.util.Properties nebo kombinace:

String url = "jdbc:databricks://<server-hostname>:<port>/<schema>";
Properties properties = new java.util.Properties();
properties.put("<property1>", "<value1");
properties.put("<property2>", "<value2");
// ...
Connection conn = DriverManager.getConnection(url, properties);

String url = "jdbc:databricks://<server-hostname>:<port>/<schema>;[property1]=[value];[property2]=[value];";
Connection conn = DriverManager.getConnection(url, "token", "12345678901234667890abcdabcd");

Prvky adresy URL připojení jsou popsány v následující tabulce.

Informace o dalších vlastnostech, včetně vlastností ověřování, vlastností konfigurace SQL a vlastností protokolování, naleznete v tématu Podporované vlastnosti připojení.

Poznámka:

Prvky a vlastnosti adres URL jsou nezávislé na velikosti písmen.

Element nebo vlastnost URL Popis
<server-hostname> Hodnota názvu hostitele serveru pro výpočetní prostředek Azure Databricks.
<port> Hodnota portu výpočetního prostředku Azure Databricks Výchozí hodnota je 443.
<schema> Název schématu. Alternativně nastavte ConnSchema vlastnost. Viz Podporované vlastnosti připojení.
httpPath Hodnota HTTP cesty výpočetního prostředku Azure Databricks Konektor vytvoří adresu HTTP, ke které se má připojit, připojením hodnoty httpPath k hostiteli a portu zadanému v adrese URL připojení. Pokud se například chcete připojit k http://localhost:10002/cliserviceadresy HTTP, použijte následující adresu URL připojení: jdbc:databricks://localhost:10002;httpPath=cliservice

Získání adresy URL připojení JDBC pro cluster Azure Databricks :

  1. Přihlaste se k pracovnímu prostoru Azure Databricks.
  2. Na bočním panelu klikněte na Compute a potom klikněte na název cílového clusteru.
  3. Na kartě Konfigurace rozbalte Rozšířené možnosti.
  4. Klikněte na záložku JDBC/ODBC.
  5. Zkopírujte adresu URL JDBC z pro použití jako adresa URL pro připojení JDBC, nebo vytvořte adresu URL z hodnot ve polích Název hostitele serveru, Porta HTTP Path.

Získání adresy URL připojení JDBC pro SQL warehouse Databricks :

  1. Přihlaste se k pracovnímu prostoru Azure Databricks.
  2. Na bočním panelu klikněte na SQL Warehouses a potom klikněte na název cílového skladu.
  3. Klikněte na kartu Podrobnosti o připojení.
  4. Zkopírujte adresu URL JDBC z pro použití jako adresa URL pro připojení JDBC, nebo vytvořte adresu URL z hodnot ve polích Název hostitele serveru, Porta HTTP Path.

Konfigurace značek dotazů

Důležité

Tato funkce je ve verzi Private Preview. Pokud chcete požádat o přístup, obraťte se na svůj tým účtů.

Připojte značky klíč-hodnota k dotazům SQL pro účely sledování a analýzy. Značky se zobrazují v system.query.history tabulce pro identifikaci a analýzu dotazů.

Pokud chcete do připojení přidat značky dotazů, zahrňte vlastnost query_tags do adresy URL JDBC:

jdbc:databricks://<server-hostname>:<port>/<schema>;query_tags=key1:value1,key2:value2

Značky dotazu používají formát páru klíč:hodnota oddělený čárkami:

  • query_tags=key:value (jedna značka)
  • query_tags=key1:value1,key2:value2,key3:value3 (více značek)

Konfigurace připojení proxy serveru

Nakonfigurujte konektor tak, aby se připojil přes proxy server místo přímého připojení k Databricks. Konektor podporuje základní a SPNEGO ověřování při připojování přes proxy server. Viz Podporované vlastnosti připojení.

Chcete-li použít nastavení proxy serveru na úrovni systému, nastavte UseProxy=1 a UseSystemProxy=1.

Ruční konfigurace nastavení proxy serveru:

  1. Nastavte UseProxy=1.
  2. Nastavit ProxyHost, ProxyPort a ProxyIgnoreList.
  3. Pokud se chcete ověřit pomocí proxy serveru, zvolte jednu metodu:
    • Základní: Set ProxyAuth=1, ProxyUIDa ProxyPWD.
    • SPNEGO (prostředí Kerberos): Ověřte svůj Kerberos uživatelský účet na úrovni systému a pak nastavte ProxyAuth=2.

Konfigurujte proxy server pro Cloud Fetch

Cloudové načítání vyžaduje samostatnou konfiguraci proxy serveru od připojení hlavního ovladače. Pomocí vlastností UseCFProxy, CFProxyHost, CFProxyPort, CFProxyAuth, CFProxyUID a CFProxyPwd připojení směrujte provoz Cloud Fetch přes proxy. Viz Podporované vlastnosti připojení.

Pokud je vaše síť soukromá, povolte *.blob.core.windows.net a *.store.core.windows.net a přidejte potřebné stažení certifikátů a jejich odvolání do seznamu povolených.

Troubleshooting

Pokud nemůžete vyřešit problémy s proxy serverem, nastavte EnableQueryResultDownload=0 možnost zakázat cloudové načítání a vraťte se do přímého stahování.

Pokud chcete diagnostikovat problémy s výkonem, nastavte LogLevel=4 na protokolování INFO úrovně. Ovladače protokolují rychlost stahování na blok dat, takže velké sady výsledků generují více řádků protokolu:

CloudFetch download speed: 21.24 MB/s
CloudFetch download speed: 20.60 MB/s

Ovladač zaznamená upozornění, když rychlost stahování klesne pod přibližně 1 MB/s. Komponenta protokolu je com.databricks.client.spark.jdbc.ResultFileDownloadHandler. Pokud jsou stahování pomalé nebo pozastavené, zvyšte CloudFetchThreadPoolSize počet paralelních stahování a stáhněte si další bloky souborů.

Konfigurace SSL

Pokud se připojujete k pracovnímu prostoru Databricks s povoleným protokolem SSL, nakonfigurujte konektor pro připojení k soketu s povoleným protokolem SSL. Konektor používá jednosměrné ověřování k ověření identity serveru.

Jednosměrné ověřování vyžaduje podepsaný důvěryhodný certifikát SSL. Nakonfigurujte konektor pro přístup ke konkrétnímu úložišti TrustStore. Pokud nezadáte TrustStore, konektor použije výchozí Java TrustStore (jssecacerts) nebo cacerts, pokud jssecacerts není k dispozici.

Konfigurace SSL:

  1. Nastavte SSL=1.
  2. Pokud nepoužíváte výchozí Java TrustStore, nakonfigurujte vlastní úložiště:
    • Vytvořte TrustStore obsahující podepsaný certifikát důvěryhodného serveru.
    • Nastavte SSLTrustStore na úplnou cestu k TrustStore.
    • Nastavte SSLTrustStorePwd na heslo TrustStore.
    • Pokud TrustStore není JKS TrustStore, nastavte SSLTrustStoreType buď BCFKS (BouncyCastle FIPS Keystore), nebo PKCS12.

Pokud chcete změnit strategii odvolání certifikátu, nastavte následující vlastnosti:

  • CheckCertRevocation: Nastavte na 0 příjem odvolaných certifikátů. Výchozí hodnota je 1.
  • AcceptUndeterminedRevocation: Nastavte na 1 příjem certifikátů se stavem nedeterminovaného odvolání (například pokud je CRLDP nedostupný nebo vyprší časový limit). Výchozí hodnota je 0.

Autentizovat ovladače

Informace o konfiguraci ověřování pro ovladač JDBC naleznete v tématu Nastavení ověřování pro ovladač Databricks JDBC.

  • Last updated on