JDBC Eklentisi

DBX varsayılan olarak yerel Rust veritabanı sürücülerini kullanır. JDBC isteğe bağlıdır: DBX'in yerel olarak desteklemediği bir veritabanına bağlanmanız ya da özellikle üreticinin JDBC sürücüsüne ihtiyacınız olduğunda JDBC eklentisini kurun.

Masaüstü, JAR dosyalarını yerel makineden içe aktarır. Docker/Web, JAR dosyalarını ve eklentiyi sunucu veri dizinine kurar; tarayıcının bulunduğu makinedeki yollar sunucu tarafından doğrudan okunamaz ve yapılandırma taşıması sürücü dosyalarını otomatik taşımaz.

JDBC Ne Zaman Kullanılır

Önce MySQL, PostgreSQL, SQLite, Redis, MongoDB, DuckDB, ClickHouse, SQL Server, Oracle, DM ve GaussDB gibi yerleşik DBX veritabanı türlerini tercih edin.

JDBC'yi şu durumlarda kullanın:

• Hedef veritabanı DBX'e yerleşik değilse
• Yerel sürücü, üreticiye özgü bir davranışı kapsamıyorsa
• Kurumunuz üreticinin JDBC sürücüsünü standart olarak kullanıyorsa
• Dameng DM, H2, DB2, Snowflake ya da SQLite gibi veritabanlarına JDBC üzerinden bağlanmak istiyorsanız

Gereksinimler

1. Adım: Java Kurun

JDBC eklentisi bir Java programıdır, bu yüzden makinenizde bir Java çalışma zamanı gerekir. Kurulumdan sonra bir terminalde doğrulayın:

java -version

Komut bulunamıyorsa önce Java kurun. DBX önce JAVA_HOME değişkenine, sonra yaygın sistem konumlarına ve PATH üzerindeki java komutuna bakar.

brew install openjdk

java -version

sudo apt install openjdk-17-jre

sudo dnf install java-17-openjdk

2. Adım: DBX JDBC Eklentisini Kurun

DBX Masaüstü'nde:

1. Ayarlar'ı açın
2. JDBC Sürücüleri bölümüne gidin
3. JDBC Eklentisini Kur'a tıklayın

Kurulumdan sonra DBX şuna benzer bir durum gösterir:

Kurulu: v0.1.0

DBX JDBC eklentisinin kendi sürümü vardır. DBX uygulama sürümüyle eşleşmesi gerekmez. DBX'i güncellemek JDBC eklentisini otomatik kurmaz ve eklentiyi elle kaldırırsanız DBX bunu arkanızdan yeniden kurmaz.

3. Adım: Üreticinin JDBC Sürücüsünü İndirin

DBX üreticilerin JDBC sürücülerini otomatik indirmez. .jar dosyasını veritabanı üreticisinin web sitesinden ya da bir Maven deposundan indirin.

Yaygın örnekler:

4. Adım: JDBC Sürücü JAR'larını İçe Aktarın

DBX'te:

1. Ayarlar'ı açın
2. JDBC Sürücüleri bölümüne gidin
3. JDBC sürücü JAR'ları bölümünde indirdiğiniz .jar dosyasını seçin

Ayrıca yerel bir JAR yolunu yapıştırıp içe aktarabilirsiniz. DBX, içe aktarılan JAR dosyalarını uygulama veri dizinine kopyalar ve yeni JDBC bağlantıları bunları sürücü açılır listesinden seçebilir.

Bir sürücüyü içe aktarmak yalnızca yerel dosyaları kopyalar. Sistem Java kurulumunuzu değiştirmez, veritabanı istemcileri kurmaz ve sürücüyü hiçbir yere yüklemez.

5. Adım: Bir JDBC Bağlantısı Oluşturun

Yeni bir bağlantı oluşturup JDBC'yi seçin.

JDBC URL'leri genellikle sunucuyu, portu ve veritabanı adını zaten içerir, bu yüzden JDBC formu ayrı sunucu ve port alanları göstermez.

Formu doldurduktan sonra Test Et'e tıklayın. Test başarılıysa Kaydet'e tıklayın; bağlantı kenar çubuğunda görünür.

Örnek: Dameng DM

DBX'te yerleşik bir DM ODBC bağlantı türü zaten var. Resmî Dameng JDBC sürücüsünü tercih ederseniz JDBC eklentisini kullanın.

1. DBX JDBC eklentisini kurun
2. Java'yı kurun
3. Dameng JDBC sürücü JAR dosyasını DM kurulum dizininizden ya da Maven deposundan alın, örneğin DmJdbcDriver8.jar veya DmJdbcDriver11.jar
4. JAR dosyasını Ayarlar → JDBC Sürücüleri bölümünde içe aktarın
5. Yeni bir bağlantı oluşturup JDBC'yi seçin
6. Şunları doldurun:

DM için dm.jdbc.driver.DmDriver değerini girmeniz önerilir; böylece bağlantı otomatik sürücü keşfi meta verisine bağlı kalmaz.

Örnek: H2 Yerel Dosya Veritabanı

H2, JDBC akışını doğrulamak için iyi bir yoldur.

1. DBX JDBC eklentisini kurun
2. H2 JDBC sürücü JAR dosyasını indirin
3. Ayarlarda h2-*.jar dosyasını içe aktarın
4. Yeni bir bağlantı oluşturup JDBC'yi seçin
5. Şunları doldurun:

Kaydettikten sonra şunu deneyin:

CREATE TABLE users (
  id INT PRIMARY KEY,
  name VARCHAR(100)
);

INSERT INTO users VALUES (1, 'Alice');

SELECT * FROM users;

Örnek: PostgreSQL

1. PostgreSQL JDBC sürücü JAR dosyasını indirin
2. Ayarlarda içe aktarın
3. Yeni bir JDBC bağlantısı oluşturun
4. Şunları doldurun:

SSL gerekiyorsa JDBC URL'sine parametre ekleyin:

jdbc:postgresql://localhost:5432/postgres?sslmode=require

Sorun Giderme

JDBC eklentisi kurulumu başarısız oluyor

Ağınızın DBX GitHub Releases adresine erişip erişemediğini denetleyin. DBX proxy URL'lerini ve özgün GitHub URL'sini dener, ancak herkese açık proxy'ler yine de erişilemez olabilir. GitHub engelliyse başka bir ağ deneyin.

Java bulunamıyor

Bir terminalde doğrulayın:

java -version

Terminal çalışıyor ama DBX çalışmıyorsa DBX'i yeniden başlatın. macOS'ta Java yalnızca bir Homebrew yolunda kuruluysa JAVA_HOME ayarını yapılandırın.

No JDBC driver was discovered

Sürücü JAR'ı otomatik keşfedilemedi. Sürücü sınıfını elle girin, örneğin:

org.postgresql.Driver
com.mysql.cj.jdbc.Driver
dm.jdbc.driver.DmDriver
oracle.jdbc.OracleDriver

No suitable driver

JDBC URL'si ile sürücü büyük olasılıkla uyuşmuyor. Şunları denetleyin:

• Seçili sürücü JAR'ı hedef veritabanına ait mi
• JDBC URL öneki doğru mu; örneğin jdbc:postgresql:, jdbc:mysql:, jdbc:dm: ya da jdbc:oracle:
• Sürücü sınıfının elle girilmesi gerekiyor olabilir

Bağlantı çalışıyor ama tablolar görünmüyor

JDBC meta verisi; veritabanı sürücüsüne ve hesap yetkilerine bağlıdır. Şunları denetleyin:

• Hesap meta veriyi okuyabiliyor mu
• JDBC URL'si beklenen veritabanını ya da şemayı gösteriyor mu
• Tablolar farklı bir şemada olabilir
• Sürücü, beklediğiniz nesneler için DatabaseMetaData destekliyor mu

Bir sürücü birden çok JAR gerektiriyor

Sürücü JAR'ları alanına her satıra bir JAR yolu girin ya da gereken her JAR'ı ayarlarda içe aktarıp kalan yolları elle ekleyin.

Kaldırma

Ayarlar → JDBC Sürücüleri bölümünde Kaldır'a tıklayın. DBX yalnızca JDBC eklentisini kaldırır, içe aktardığınız üretici sürücü JAR'larını korur; böylece eklentiyi daha sonra yeniden kurarsanız bunları tekrar içe aktarmanız gerekmez.

Geliştiriciler için: Eklenti Protokolü

DBX, eklenti çalıştırılabilirini başlatır ve stdin/stdout üzerinden JSON Lines istek ve yanıtları alışverişi yapar. Bir bağlantı kurulduktan sonra DBX, o bağlantıdaki sorgular ve meta veri istekleri için aynı eklenti işlemini yeniden kullanır.

Eklenti dizini bir manifest.json dosyası içermelidir:

{
  "id": "jdbc",
  "name": "DBX JDBC Plugin",
  "version": "0.1.0",
  "protocol_version": 1,
  "description": "Adds JDBC driver support.",
  "executable": "bin/dbx-jdbc-plugin",
  "drivers": [
    {
      "id": "jdbc",
      "label": "JDBC",
      "kind": "external",
      "database_type": "jdbc"
    }
  ]
}

Geçerli DBX uygulaması eklenti protokolü sürüm 1 destekler. DBX, bildiriminde farklı bir protokol sürümü belirten bir eklentiyi reddeder ve her eklenti isteğinin 30 saniyelik bir zaman aşımı vardır; böylece takılan bir sürücü işlemi uygulamayı süresiz engellemez.

İlk protokol; testConnection, connect, executeQuery, listDatabases, listSchemas, listTables ve getColumns işlemlerini destekler.