CREATE DATABASE LINK

説明

このステートメントは、指定されたリモートデータベースにアクセスするためのdblinkを作成します。このステートメントでは、dblinkの名前を指定し、リモートデータベースのユーザー名、テナント名、データベース名、パスワード、IPアドレス、ポート番号、およびクラスタ名を提供する必要があります。

OceanBaseデータベースのMySQLモードでは、現在ローカルOceanBaseクラスタのMySQLテナントがリモートOceanBaseクラスタのMySQLテナントのデータを読み取ることのみサポートされています。同一クラスタ内の異なるMySQLテナント間でもdblinkを作成できます。ただし、OceanBaseクラスタのMySQLテナントがネイティブMySQLデータを読み取ること、またはネイティブMySQLがOceanBaseクラスタのMySQLテナントデータを読み取ることは、現時点ではサポートされていません。

OceanBaseデータベースのMySQLモードにおけるdblinkは、以下のデータ型の読み取りをサポートしています。

• 数値型：TINYINT、SMALLINT、MEDIUMINT、INT、BIGINT、FLOAT、DOUBLE、DECIMAL。

• 日付時刻型：DATE、TIME、YEAR、DATETIME、TIMESTAMP。

• 文字列型：CHAR、VARCHAR、TINYBLOB、TINYTEXT、BLOB、TEXT、MEDIUMTEXT、LONGBLOB、LONGTEXT。

• その他の型：ENUM、SET。

構文

CREATE DATABASE LINK [IF NOT EXISTS] dblink_name CONNECT TO user_name@tenant_name DATABASE database_name IDENTIFIED BY password HOST 'ip:port' [CLUSTER cluster_name];

説明

例

• リモートのOceanBaseクラスタ上の特定のOBServerノードに接続するためのdblinkを作成します。名前はob_dblinkです。リモートデータベースのテナントはmysql（任意のMySQLテナントを指定できます）、ユーザーはuser1、データベースはtestです。ユーザーは実際の環境に応じてパスワード、IPアドレス、ポート番号を指定します。

  obclient> CREATE DATABASE LINK IF NOT EXISTS ob_dblink  CONNECT TO user1@mysql DATABASE test IDENTIFIED BY '******' HOST 'xx.xx.xx.xx:xx';
  Query OK, 1 row affected
  

• リモートのOceanBaseクラスタに接続するためのdblinkを作成します。名前はob_dblink_proxyです。リモートデータベースのテナントはデフォルトのmysql（任意のMySQLテナントを指定できます）、ユーザーはuser1、データベースはtestです。ユーザーは実際の環境に応じてパスワード、IPアドレス、ポート番号を指定します。

  obclient> CREATE DATABASE LINK IF NOT EXISTS  ob_dblink_proxy CONNECT TO user1@mysql DATABASE test IDENTIFIED BY '******' HOST 'xx.xx.xx.xx:xx' CLUSTER "obcluster";
  Query OK, 1 row affected
  

dblinkを作成した後、クエリや削除などの操作が可能になります。詳細については、SELECTを参照してください。

ユーザーは、ビューoceanbase.DBA_DB_LINKSを使用して作成されたdblink情報を照会できます。詳細については、DBA_DB_LINKSを参照してください。

関連ドキュメント

SELECT

DBA_DB_LINKS