説明
このステートメントは、データベース内に外部データカタログ(External Catalog)を作成するために使用されます。これは外部データソースに接続し、外部データのメタ情報を取得するために使用されます。データのインポートや移行を行うことなく、このカタログを通じて直接外部データをクエリできます。
説明
OceanBaseデータベースV4.3.5では、V4.3.5 BP2バージョンから CREATE EXTERNAL CATALOG ステートメントがサポートされています。
制限事項と注意点
現在、ODPSタイプの外部カタログのみの作成がサポートされています。
権限要件
CREATE EXTERNAL CATALOG ステートメントを実行するには、現在のユーザーが CREATE CATALOG 権限を持っている必要があります。OceanBaseデータベースの権限の詳細については、MySQLモードの権限分類を参照してください。
構文
CREATE EXTERNAL CATALOG [IF NOT EXISTS] external_catalog_name
PROPERTIES [=] (
TYPE = 'ODPS',
[ACCESSTYPE = 'accesstype_string',]
ACCESSID = 'string',
ACCESSKEY = 'string',
STSTOKEN = 'string',
ENDPOINT = 'string',
TUNNEL_ENDPOINT = 'string',
PROJECT_NAME = 'string',
[QUOTA_NAME = 'string',]
[COMPRESSION = 'compression_string',]
REGION = 'string'
);
accesstype_string:
aliyun
| sts
| app
compression_string:
zlib
| zstd
| lz4
| odps_lz4
パラメータの説明
| パラメータ | 説明 |
|---|---|
| IF NOT EXISTS | オプション。この句を指定すると、作成対象の外部データディレクトリが現在のテナント内に既に存在している場合でもエラーは報告されず、システムから警告メッセージが表示されます。指定しない場合はエラーが報告されます。 |
| external_catalog_name | 作成する外部データディレクトリの名前を指定します。 |
| TYPE | 外部データディレクトリのタイプを指定します。現行バージョンでは値は ODPS です。これは、外部テーブルがMaxComputeデータの読み書きを行う場合の値です。 |
| ACCESSTYPE | オプション。MaxComputeのアカウントタイプで、デフォルト値は aliyun です。アカウントタイプの値（大文字と小文字は区別されません）は以下のとおりです：
|
| ACCESSID | ACCESSTYPE の値が aliyun/app アカウントタイプ、または空の場合、aliyun/app アカウント、またはMaxComputeへのアクセス権限を持つRAMユーザーのAccessKey IDです。 |
| ACCESSKEY | ACCESSTYPE の値が aliyun/app アカウントタイプ、または空の場合、aliyun/app アカウント、またはMaxComputeへのアクセス権限を持つRAMユーザーのAccessKey Secretです。 |
| STSTOKEN | ACCESSTYPE の値が sts アカウントタイプの場合、ここはMaxComputeサービスへのアクセス用のtokenです。 |
| ENDPOINT | MaxComputeのEndPoint（ドメインノード）を指定します。 |
| TUNNEL_ENDPOINT | Tunnel Endpointを表します。MaxCompute CatalogはTunnel SDKを使用してデータを取得します。 |
| PROJECT_NAME | MaxCompute内のプロジェクトスペース名を指定します。プロジェクトスペース（Project）はMaxComputeの基本的な組織単位であり、従来のデータベースのDatabaseやSchemaの概念に似ています。 |
| QUOTA_NAME | オプション。QuotaはMaxComputeにおいて計算リソースプール（計算、アクセス、書き込み）を表します。ユーザーが対応するQuotaを設定した場合、このパラメータで特定のQuotaを指定します。 |
| COMPRESSION | オプション。データソースの圧縮形式を指定します。設定しない場合は圧縮は有効になりません。値（大文字と小文字は区別されません）は以下のとおりです：
|
| REGION | MaxComputeが有効なリージョンを指定します。 |
例
CREATE EXTERNAL CATALOG test_odps_catalog
PROPERTIES = (
TYPE = 'ODPS',
ACCESSID = '$odps_accessid',
ACCESSKEY = '$odps_accesskey',
ENDPOINT = '$odps_endpoint',
TUNNEL_ENDPOINT = 'http://dt.cn-hangzhou.maxcompute.aliyun.com',
PROJECT_NAME = 'mysqltest_regression_sqlqa',
QUOTA_NAME = '',
COMPRESSION_CODE = ''
);