メインコンテンツまでスキップ
バージョン: Stable-3.3

CREATE FILE

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

ヒント

この操作には、SYSTEM レベルの FILE 権限が必要です。この権限を付与するには、 GRANT の指示に従ってください。

基本概念​

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

構文​

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

パラメータ​

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

properties の設定項目

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