CREATE FILE

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

基本概念

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

構文

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

パラメータ

パラメータ	必須	説明
file_name	はい	ファイルの名前。
database	いいえ	ファイルが属するデータベース。このパラメータを指定しない場合、このパラメータは現在のセッションでアクセスするデータベースの名前にデフォルト設定されます。
properties	はい	ファイルのプロパティ。以下の表は、プロパティの設定項目を説明しています。

properties の設定項目

設定項目	必須	説明
url	はい	ファイルをダウンロードできる URL。認証されていない HTTP URL のみがサポートされます。ファイルが StarRocks に保存された後は、URL は不要です。
catalog	はい	ファイルが属するカテゴリ。ビジネス要件に基づいて catalog を指定できます。ただし、特定の状況では、このパラメータを特定の catalog に設定する必要があります。例えば、Kafka からデータをロードする場合、StarRocks は Kafka データソースの catalog でファイルを検索します。
MD5	いいえ	ファイルをチェックするために使用されるメッセージダイジェストアルゴリズム。このパラメータを指定すると、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"
);