Połączenie do programu SQL Workbench/J

  • Artykuł

W tym artykule opisano sposób używania programu SQL Workbench/J z usługą Azure Databricks.

Uwaga

W tym artykule opisano program SQL Workbench/J, który nie jest ani udostępniany, ani obsługiwany przez usługę Databricks. Aby skontaktować się z dostawcą, zobacz forum pomocy technicznej programu SQL Workbench/J w grupach Google.

Wymagania

  • SQL Workbench/J.

  • Sterownik JDBC usługi Databricks. Pobierz sterownik JDBC usługi Databricks na lokalną maszynę dewelopera, wyodrębniając DatabricksJDBC42.jar plik z pobranego DatabricksJDBC42-<version>.zip pliku.

    Uwaga

    Ten artykuł został przetestowany w systemach macOS, SQL Workbench/J Build 130, Zulu OpenJDK 21.0.1 i Sterownik JDBC usługi Databricks 2.6.36.

    W przypadku uwierzytelniania usługi Azure Databricks, jeśli nie używasz uwierzytelniania osobistego tokenu dostępu usługi Azure Databricks, możesz pominąć generowanie osobistego tokenu dostępu w dalszej części tych wymagań. Aby uzyskać więcej informacji na temat dostępnych typów uwierzytelniania usługi Azure Databricks, zobacz Ustawienia uwierzytelniania sterownika JDBC usługi Databricks.

  • Klaster lub magazyn SQL w obszarze roboczym usługi Azure Databricks.

  • Szczegóły połączenia dla klastra lub usługi SQL Warehouse, w szczególności wartości Nazwa hosta serwera, Port i Ścieżka HTTP.

  • Osobisty token dostępu usługi Azure Databricks lub token microsoft Entra ID (dawniej Azure Active Directory). Aby utworzyć osobisty token dostępu, wykonaj następujące czynności:

    1. W obszarze roboczym usługi Azure Databricks kliknij nazwę użytkownika usługi Azure Databricks na górnym pasku, a następnie wybierz pozycję Ustawienia z listy rozwijanej.
    2. Kliknij pozycję Deweloper.
    3. Obok pozycji Tokeny dostępu kliknij pozycję Zarządzaj.
    4. Kliknij pozycję Generuj nowy token.
    5. (Opcjonalnie) Wprowadź komentarz, który pomaga zidentyfikować ten token w przyszłości i zmienić domyślny okres istnienia tokenu na 90 dni. Aby utworzyć token bez okresu istnienia (niezalecane), pozostaw puste pole Okres istnienia (dni) (puste).
    6. Kliknij pozycję Generate (Generuj).
    7. Skopiuj wyświetlony token do bezpiecznej lokalizacji, a następnie kliknij przycisk Gotowe.

    Uwaga

    Pamiętaj, aby zapisać skopiowany token w bezpiecznej lokalizacji. Nie udostępniaj skopiowanego tokenu innym osobom. W przypadku utraty skopiowanego tokenu nie można wygenerować tego samego tokenu. Zamiast tego należy powtórzyć tę procedurę, aby utworzyć nowy token. Jeśli utracisz skopiowany token lub uważasz, że token został naruszony, usługa Databricks zdecydowanie zaleca natychmiastowe usunięcie tego tokenu z obszaru roboczego, klikając ikonę kosza (Odwołaj) obok tokenu na stronie Tokeny dostępu.

    Jeśli nie możesz utworzyć lub użyć tokenów w obszarze roboczym, może to być spowodowane tym, że administrator obszaru roboczego wyłączył tokeny lub nie udzielił Ci uprawnień do tworzenia lub używania tokenów. Zobacz administratora obszaru roboczego lub następujące elementy:

    Uwaga

    Najlepszym rozwiązaniem w zakresie zabezpieczeń w przypadku uwierzytelniania za pomocą zautomatyzowanych narzędzi, systemów, skryptów i aplikacji usługa Databricks zaleca używanie osobistych tokenów dostępu należących do jednostek usługi zamiast użytkowników obszaru roboczego. Aby utworzyć tokeny dla jednostek usługi, zobacz Zarządzanie tokenami dla jednostki usługi.

Kroki nawiązywania połączenia z usługą Workbench/J

Aby nawiązać połączenie z usługą Workbench/J, wykonaj następujące czynności:

  1. Uruchom program SQL Workbench/J.
  2. Wybierz pozycję Plik > Połączenie okno.
  3. W oknie dialogowym Wybieranie profilu Połączenie ion kliknij pozycję Zarządzaj sterownikami.
    1. W polu Nazwa wpisz Databricks.
    2. W polu Biblioteka kliknij ikonę Wybierz pliki JAR. Przejdź do katalogu, w którym wyodrębniono DatabricksJDBC42.jar plik z pobranego DatabricksJDBC42-<version>.zip pliku, a następnie wybierz plik JAR. Następnie kliknij pozycję Wybierz.
    3. Sprawdź, czy pole Classname jest wypełnione ciągiem com.databricks.client.jdbc.Driver.
    4. Kliknij przycisk OK.
  4. Kliknij ikonę Utwórz nowy profil połączenia.
    1. Wpisz nazwę profilu.
    2. W polu Sterownik wybierz pozycję Databricks (com.databricks.client.jdbc.Driver).
    3. W polu Adres URL wprowadź adres URL JDBC dla zasobu usługi Azure Databricks. Aby uzyskać informacje o składni pola adresu URL dla adresów URL JDBC, zobacz Ustawienia uwierzytelniania sterownika JDBC usługi Databricks.
    4. Kliknij przycisk Test.
    5. Kliknij przycisk OK dwa razy.

Dodatkowe zasoby