メインコンテンツまでスキップ

CREATE FILE

ファイルの作成

CREATE FILEステートメントを使用してファイルを作成できます。ファイルが作成されると、ファイルはStarRocksにアップロードされて永続化されます。データベースでは、管理者ユーザーのみがファイルを作成および削除でき、データベースにアクセスする権限を持つすべてのユーザーは、データベースに属するファイルを使用することができます。

基本的な概念

ファイル: StarRocksで作成および保存されるファイルを指します。ファイルがStarRocksに作成および保存されると、StarRocksはファイルに一意のIDを割り当てます。データベース名、カタログ、およびファイル名に基づいてファイルを検索することができます。

構文

CREATE FILE "file_name" [IN database]
[properties]

パラメータ

パラメータ

必須

説明

file_name

Yes

ファイルの名前。

database

No

ファイルが属するデータベース。このパラメータを指定しない場合、このパラメータは現在のセッションでアクセスするデータベースの名前をデフォルトにします。

properties

Yes

ファイルのプロパティ。プロパティの設定項目については、以下の表に記載しています。

**properties**の設定項目

設定項目

必須

説明

url

Yes

ファイルをダウンロードできるURL。認証されていないHTTP URLのみがサポートされます。ファイルがStarRocksに保存されると、URLはもはや必要ありません。

catalog

Yes

ファイルが属するカタログ。ビジネス要件に基づいてカタログを指定できますが、一部の状況では、このパラメータを特定のカタログに設定する必要があります。たとえば、Kafkaからデータをロードする場合、StarRocksはKafkaデータソースのカタログからファイルを検索します。

MD5

No

ファイルをチェックするために使用されるメッセージダイジェストアルゴリズム。このパラメータを指定すると、ファイルのダウンロード後にStarRocksがファイルをチェックします。

  • kafkaというカテゴリーの下に test.pem という名前のファイルを作成します。
CREATE FILE "test.pem"
PROPERTIES
(
"url" = "https://starrocks-public.oss-cn-xxxx.aliyuncs.com/key/test.pem",
"catalog" = "kafka"
);
  • my_catalog というカテゴリーの下に client.key という名前のファイルを作成します。
CREATE FILE "client.key"
IN my_database
PROPERTIES
(
"url" = "http://test.bj.bcebos.com/kafka-key/client.key",
"catalog" = "my_catalog",
"md5" = "b5bb901bf10f99205b39a46ac3557dd9"
);