Tüm Ürünler
Search
Belge Merkezi

E-MapReduce:JDBC Catalog

Son Güncelleme:Oct 04, 2026

JDBC Catalog, EMR Serverless StarRocks üzerinden MySQL ve PostgreSQL veritabanlarını doğrudan sorgulamanızı sağlayan bir External Catalog'tur. Veri taşımaya gerek kalmaz. StarRocks v3.0 ve sonraki sürümler JDBC Catalog'u destekler.

JDBC Catalog ile şunları yapabilirsiniz:

  • MySQL, PostgreSQL ve bu protokollerle uyumlu veri kaynaklarında bulunan verilere doğrudan sorgu gönderin.

  • JDBC kaynaklarından gelen verileri INSERT INTO kullanarak StarRocks tablolarına yükleyin.

JDBC catalog oluşturma

Söz dizimi

CREATE EXTERNAL CATALOG <catalog_name>
[COMMENT <comment>]
PROPERTIES
(
  "key"="value",
  ...
);

Parametreler

  • catalog_name: Zorunludur. JDBC catalog'un adıdır.

    • Harfler, rakamlar ve alt çizgi (_) içerebilir. Bir harfle başlamalıdır.

    • Uzunluk: 1–64 karakter.

  • comment: İsteğe bağlıdır. JDBC catalog için açıklama metni içerir.

  • PROPERTIES: JDBC catalog bağlantı özellikleridir. Aşağıdaki tablodaki tüm özellikler zorunludur.

Property Description
type Veri kaynağı türüdür. Değer olarak jdbc ayarlayın.
user Veritabanına bağlanmak için kullanılan kullanıcı adıdır.
password Veritabanına bağlanmak için kullanılan şifredir.
jdbc_uri JDBC sürücüsü için bağlantı URI'sidir. MySQL için "jdbc:mysql://ip:port", PostgreSQL için "jdbc:postgresql://ip:port/db_name" biçimini kullanın.
driver_url JDBC sürücü JAR paketini indirmek için kullanılan URL'dir. Serverless StarRocks örneği için JAR paketini genel okuma (public-read) erişimiyle Object Storage Service (OSS) üzerine yükleyin ve bu özelliği OSS paketinin dahili uç noktasını kullanan bir HTTP URL'sine ayarlayın. Örnek: http://<YourBucketName>.oss-cn-xxxx-internal.aliyuncs.com/mysql-connector-java-*.jar. JAR paketini yükleme talimatları için bkz. Simple upload. Gerekli erişim izinlerini yapılandırmak için bkz. Set the ACL for a bucket.
driver_class JDBC sürücüsünün sınıf adıdır. MySQL 5.x ve önceki sürümler için com.mysql.jdbc.Driver kullanın. MySQL 6.x ve sonraki sürümler için com.mysql.cj.jdbc.Driver kullanın. PostgreSQL için org.postgresql.Driver kullanın.

Örnek

-- MySQL
CREATE EXTERNAL CATALOG mysql_catalog
PROPERTIES
(
    "type"="jdbc",
    "user"="root",
    "password"="xxxxx",
    "jdbc_uri"="jdbc:mysql://127.0.0.1:3306",
    "driver_url"="http://<YourBucketName>.oss-cn-xxxx-internal.aliyuncs.com/mysql-connector-java-*.jar",
    "driver_class"="com.mysql.cj.jdbc.Driver"
);
Not

mysql-connector-java-*.jar ifadesini MySQL JDBC sürücü JAR paketinizin gerçek sürüm adıyla değiştirin.

JDBC catalog'ları görüntüleme

Geçerli StarRocks kümesindeki tüm catalog'ları listelemek için:

SHOW CATALOGS;

Belirli bir catalog'un oluşturma ifadesini görüntülemek için (örneğin jdbc0):

SHOW CREATE CATALOG jdbc0;

JDBC catalog silme

Bir JDBC catalog'u silmek için (örneğin jdbc0):

DROP CATALOG jdbc0;

JDBC catalog üzerinden veri sorgulama

Seçenek 1: Bağlamı değiştirin, ardından sorgulayın

  1. Catalog içindeki veritabanlarını listeleyin:

    SHOW DATABASES FROM <catalog_name>;
  2. Catalog'a geçiş yapın ve etkin veritabanını ayarlayın:

    SET CATALOG <catalog_name>;
    USE <db_name>;

    Alternatif olarak, doğrudan veritabanına geçiş yapabilirsiniz:

    USE <catalog_name>.<db_name>;
  3. Hedef tablo üzerinde sorgu çalıştırın:

    SELECT * FROM <table_name>;

Seçenek 2: Tam nitelikli tablo adı

Bağlam değiştirmeden üç parçalı ad kullanarak sorgulama yapın:

SELECT * FROM <catalog_name>.<database_name>.<table_name>;

SSS

S: "Malformed database URL, failed to parse the main URL sections" hatasını nasıl çözerim?

jdbc_uri değeri hatalı biçimlendirilmiştir. Biçimi kontrol edin:

  • MySQL: jdbc:mysql://ip:port

  • PostgreSQL: jdbc:postgresql://ip:port/db_name

Fazladan boşluk, eksik iki nokta üst üste işaretleri veya hatalı eğik çizgiler olmadığından emin olun. Ayrıntılar için yukarıdaki jdbc_uri parametresi açıklamasına bakın.