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 INTOkullanarak 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"
);
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
-
Catalog içindeki veritabanlarını listeleyin:
SHOW DATABASES FROM <catalog_name>; -
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>; -
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:portPostgreSQL:
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.