Databricks JDBC Sürücüsü (OSS)

Databricks, veritabanı yönetim sistemlerine erişmek için endüstri standardı bir belirtim olan Java Veritabanı Bağlantısı (JDBC) aracılığıyla DataGrip, DBeaver ve SQL Workbench/J gibi araçları Azure Databricks'e bağlamanızı sağlayan bir açık kaynak yazılımı (OSS) JDBC sürücüsü sağlar.

Bu sürücü JDBC API'lerini uygulamıştır ve OAuth, Cloud Fetch ve Unity Kataloğu birim alımı gibi özellikler de dahil olmak üzere temel işlevler sağlar. Yerel sorgu modunu çalıştırır ve yerel parametreli sorguyu destekler ve yararlı sorgu sonucu saklama özelliğini veya Thrift'i sağlayan Deyim Yürütme API'lerini kullanarak çalıştırılabilir.

Bu makalede Databricks JDBC Sürücüsünü (OSS) yükleme ve kullanma hakkında bilgi sağlanır. OSS Olmayan Databricks JDBC Sürücüsü hakkında bilgi için bkz . Databricks JDBC Sürücüsü.

Gereksinimler

Databricks JDBC Sürücüsünü (OSS) kullanmak için aşağıdaki gereksinimlerin karşılanması gerekir:

• Java Çalışma Zamanı Ortamı (JRE) 11.0 veya üzeri. CI testi JRE 11, 17 ve 21'de desteklenir.

Sürücüyü yükleme

Databricks JDBC Sürücüsü (OSS), Maven Deposunda yayımlanır. En son sürüm 0.9.1-oss'dir.

Sürücüyü yüklemek için aşağıdakilerden herhangi birini yapabilirsiniz:

• Maven projeleri için, Maven'a pom.xml belirtilen sürüme sahip JDBC sürücüsünü otomatik olarak indirmesini bildirmek için projenin dosyasına aşağıdaki bağımlılığı ekleyin:

  <dependency>
    <groupId>com.databricks</groupId>
    <artifactId>databricks-jdbc</artifactId>
    <version>0.9.1-oss</version>
    <scope>runtime</scope>
  </dependency>
  

• Gradle projeleri için, Gradle'a belirtilen sürüme sahip JDBC sürücüsünü otomatik olarak indirmesini bildirmek için projenin derleme dosyasına aşağıdaki bağımlılığı ekleyin:

  implementation 'com.databricks:databricks-jdbc:0.9.1-oss'
  

Diğer proje türlerinin bağımlılık söz dizimini görüntülemek ve Databricks JDBC Sürücüsünün (OSS) en son sürüm numarasını almak için Maven Deposu'na bakın.

Bağlantı URL'sini yapılandırma

JDBC sürücüsünü kullanarak Azure Databricks çalışma alanınıza bağlanmak için, Azure Databricks çalışma alanınızın sunucu ana bilgisayar adı, işlem kaynağı ayarları ve çalışma alanına bağlanmak için kimlik doğrulaması kimlik bilgileri gibi çeşitli bağlantı ayarlarını içeren bir JDBC bağlantı URL'si belirtmeniz gerekir.

JDBC bağlantı URL'sinde bu özelliklerin değerini ayarlayabilir, bunları DriverManager.getConnection yöntemine veya her ikisinin bir bileşimine geçirebilirsiniz. Belirli uygulamanızı, istemcinizi, SDK'nızı, API'nizi veya SQL aracınızı kullanarak en iyi şekilde bağlanmayı öğrenmek için sağlayıcının belgelerine bakın.

JDBC bağlantı URL'si aşağıdaki biçimde olmalıdır. Özellikler büyük/küçük harfe duyarlı değildir.

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

Alternatif olarak, sınıfını veya bileşimini java.util.Properties kullanarak ayarları belirtin:

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");

Bağlantı URL'si öğeleri aşağıdaki tabloda açıklanmıştır. Kimlik doğrulama özellikleri de dahil olmak üzere ek özellikler hakkında bilgi için aşağıdaki bölümlere bakın. URL öğeleri ve özellikleri büyük/küçük harfe duyarlı değildir.

Azure Databricks kümesinin JDBC bağlantı URL'sini almak için:

1. Azure Databricks çalışma alanınıza giriş yapın.
2. Kenar çubuğunda İşlem'e ve ardından hedef kümenin adına tıklayın.
3. Yapılandırma sekmesinde Gelişmiş seçenekler'i genişletin.
4. JDBC/ODBC sekmesine tıklayın.
5. JDBC bağlantı URL'si olarak kullanmak için JDBC URL'sini kopyalayın veya Sunucu ana bilgisayar adı, Bağlantı Noktası ve HTTP Yolu alanlarındaki değerlerden URL'yi yapın.

Databricks SQL ambarı için JDBC bağlantı URL'sini almak için:

1. Azure Databricks çalışma alanınıza giriş yapın.
2. Kenar çubuğunda SQL Ambarları'na ve ardından hedef ambarın adına tıklayın.
3. Bağlantı ayrıntıları sekmesine tıklayın.
4. JDBC bağlantı URL'si olarak kullanmak için JDBC URL'sini kopyalayın veya Sunucu ana bilgisayar adı, Bağlantı Noktası ve HTTP Yolu alanlarındaki değerlerden URL'yi yapın.

Sürücünün kimliğini doğrulama

Aşağıdaki kimlik doğrulama mekanizmalarından birini kullanarak JDBC sürücü bağlantısının kimliğini doğrulayabilirsiniz:

• OAuth kullanıcıdan makineye (U2M) kimlik doğrulaması (Önerilen)
• OAuth makineden makineye (M2M) kimlik doğrulaması
• Azure Databricks kişisel erişim belirteci

OAuth kullanıcıdan makineye (U2M) kimlik doğrulaması

JDBC sürücüsü, gerçek zamanlı insan oturum açma ve hedef Databricks kullanıcı hesabının kimliğini doğrulama onayı için OAuth kullanıcıdan makineye (U2M) kimlik doğrulamasını destekler. Bu, tarayıcı tabanlı OAuth kimlik doğrulaması olarak da bilinir.

Azure Databricks, müşteriler için OAuth istemci kimliğini databricks-sql-jdbc oluşturmuştur. Bu aynı zamanda JDBC sürücüsünde kullanılan varsayılan OAuth istemci kimliğidir. OAuth U2M kimlik doğrulamasını yapılandırmak için mevcut JDBC bağlantı URL'nize veya java.util.Properties nesnenize aşağıdaki özellikleri eklemeniz gerekir:

OAuth makineden makineye (M2M) kimlik doğrulaması

JDBC sürücüsü, Azure Databricks hizmet sorumlusu kullanarak OAuth makineden makineye (M2M) kimlik doğrulamasını destekler. Bu, OAuth 2.0 istemci kimlik bilgileri kimlik doğrulaması olarak da bilinir. Bkz . OAuth (OAuth M2M) kullanarak hizmet sorumlusuyla Azure Databricks'e erişimin kimliğini doğrulama.

OAuth M2M veya OAuth 2.0 istemci kimlik bilgileri kimlik doğrulamasını yapılandırmak için:

1. Microsoft Entra Id yönetilen hizmet sorumlusu oluşturun ve ardından bunu Azure Databricks hesaplarına ve çalışma alanlarına atayın. Ayrıntılar için bkz . Hizmet sorumlularını yönetme.

   Önemli

   Databricks JDBC Sürücüsü (OSS), OAuth M2M veya OAuth 2.0 istemci kimlik bilgileri kimlik doğrulaması için Azure Databricks OAuth gizli dizilerini destekler. Microsoft Entra Id gizli dizileri desteklenmez.

2. Hizmet sorumlusu için bir Azure Databricks OAuth gizli dizisi oluşturun. Bunu yapmak için bkz . OAuth M2M kimlik doğrulaması için erişim belirteçlerini el ile oluşturma ve kullanma.

3. Hizmet sorumlusuna kümenize veya ambarınıza erişim verin. Bkz. İşlem izinleri veya SQL ambarı yönetme.

Mevcut JDBC bağlantı URL'nize veya java.util.Properties nesnenize aşağıdaki özellikleri ekleyin:

Azure Databricks kişisel erişim belirteci

Azure Databricks kişisel erişim belirtecini kullanarak JDBC sürücü bağlantınızın kimliğini doğrulamak için JDBC bağlantı URL'nize veya java.util.Properties nesnenize aşağıdaki özellikleri ekleyin:

Bağlantı özellikleri

Aşağıdaki ek bağlantı özellikleri JDBC sürücüsü tarafından desteklenir. Özellikler büyük/küçük harfe duyarlı değildir.

SQL yapılandırma özellikleri

Aşağıdaki SQL yapılandırma özellikleri JDBC sürücüsü tarafından desteklenir. Bunlar Yapılandırma parametreleri bölümünde de açıklanmıştır. Özellikler büyük/küçük harfe duyarlı değildir.

Günlüğe kaydetme özellikleri

Aşağıdaki günlük özellikleri JDBC sürücüsü tarafından desteklenir. Özellikler büyük/küçük harfe duyarlı değildir.

Örnek: JDBC sürücüsünü kullanarak sorgu çalıştırma

Aşağıdaki örnekte, Azure Databricks işlem kaynağı kullanarak Databricks SQL sorgusu çalıştırmak için JDBC sürücüsünün nasıl kullanılacağı gösterilmektedir.

import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.ResultSet;
import java.sql.ResultSetMetaData;
import java.sql.Statement;
import java.util.Properties;

public class DatabricksJDBCExample {

    public static void main(String[] args) {

        Class.forName("com.databricks.client.jdbc.Driver");

        // Set JDBC URL properties
        String jdbcUrl = "jdbc:databricks://dbc-a1b2345c-d6e7.cloud.databricks.com:443";
        Properties connectionProperties = new Properties();
        connectionProperties.put("httpPath", "sql/protocolv1/o/123456780012345/0123-123450-z000pi22");
        connectionProperties.put("ssl", "1");

        // Set authentication properties (personal access token)
        connectionProperties.put("AuthMech", "3");
        connectionProperties.put("user", "token");
        connectionProperties.put("password", "12345678901234667890abcdabcd");

        // Set logging properties
        connectionProperties.put("logPath", "logs/myapplication.log");

        // Establish connection and execute query
        try (Connection connection = DriverManager.getConnection(jdbcUrl, connectionProperties);
             Statement statement = connection.createStatement();
             ResultSet resultSet = statement.executeQuery("SELECT * FROM samples.nyctaxi.trips")) {

            // Get metadata and column names
            ResultSetMetaData metaData = resultSet.getMetaData();
            String[] columns = new String[metaData.getColumnCount()];
            for (int i = 0; i < columns.length; i++) {
                columns[i] = metaData.getColumnName(i + 1);
            }

            // Process and print the result set
            while (resultSet.next()) {
                System.out.print("Row " + resultSet.getRow() + "=[");
                for (int i = 0; i < columns.length; i++) {
                    if (i != 0) {
                        System.out.print(", ");
                    }
                    System.out.print(columns[i] + "='" + resultSet.getObject(i + 1) + "'");
                }
                System.out.println("]");
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

Ek kaynaklar

• Azure Databricks ile DataGrip tümleştirmesi

• Azure Databricks ile DBeaver tümleştirmesi

• SQL Workbench/J'ye bağlanma

• Infoworks'e bağlanma

• Qlik Çoğaltma'ya bağlanma

• StreamSets'e bağlanma

• Syncsort'a bağlanma

• MicroStrategy'ye bağlanma