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

File manager

ファイルマネージャー

ファイルマネージャーを使用すると、公開鍵ファイル、秘密鍵ファイル、および証明書ファイルなどの外部データソースへのアクセスに使用されるファイルを作成、表示、および削除することができます。作成したファイルは、コマンドを使用して参照またはアクセスすることができます。

基本的な概念​

ファイル: StarRocksで作成して保存されるファイルを指します。ファイルがStarRocksに作成され、保存されると、StarRocksはそのファイルに一意のIDを割り当てます。データベース名、カタログ、およびファイル名に基づいてファイルを検索することができます。データベース内では、管理者ユーザーのみがファイルを作成および削除でき、データベースへのアクセス権限を持つすべてのユーザーはデータベースに属するファイルを使用することができます。

開始する前に​

  • 各FEに対して次のパラメータを設定してください。
    • small_file_dir: アップロードされたファイルが保存されるパスです。デフォルトのパスはsmall_files/で、FEのランタイムディレクトリにあります。このパラメータをfe.confファイルに指定し、FEを再起動して変更を有効にする必要があります。
    • max_small_file_size_bytes: 単一のファイルの最大サイズです。このパラメータのデフォルト値は1MBです。ファイルのサイズがこのパラメータの値を超える場合、ファイルは作成できません。このパラメータをADMIN SET CONFIGステートメントを使用して指定することができます。
    • max_small_file_number: クラスタ内で作成できるファイルの最大数です。このパラメータのデフォルト値は100です。作成したファイルの数がこのパラメータの値に達すると、ファイルの作成を続行できなくなります。このパラメータをADMIN SET CONFIGステートメントを使用して指定することができます。

注意: これらの2つのパラメータの値を増やすと、FEのメモリ使用量が増えます。そのため、必要でない限り、これらのパラメータの値を増やさないことをお勧めします。

  • 各BEに対して次のパラメータを設定してください。

small_file_dir: ダウンロードされたファイルが保存されるパスです。デフォルトのパスはlib/small_files/で、BEのランタイムディレクトリにあります。このパラメータをbe.confファイルに指定することができます。

ファイルの作成​

CREATE FILEステートメントを実行して、ファイルを作成することができます。詳細については、CREATE FILEを参照してください。ファイルが作成されると、ファイルはStarRocksにアップロードされ、永続化されます。

ファイルの表示​

SHOW FILEステートメントを実行して、データベースに保存されているファイルの情報を表示することができます。詳細については、SHOW FILEを参照してください。

ファイルの削除​

DROP FILEステートメントを実行して、ファイルを削除することができます。詳細については、DROP FILEを参照してください。

FEおよびBEがファイルを使用する方法​

  • FE: SmallFileMgrクラスは、FEの指定されたディレクトリに関連するファイルデータを保存します。その後、SmallFileMgrクラスはFEがファイルを使用するためのローカルファイルパスを返します。
  • BE: BEは**/api/get_small_file API**（HTTP）を呼び出してファイルを指定されたディレクトリにダウンロードし、ファイルの情報を記録します。BEがファイルを使用する必要がある場合、BEはファイルがダウンロードされたかどうかを確認し、ファイルを検証します。ファイルが検証に合格した場合、ファイルのパスが返されます。ファイルが検証に合格しない場合、ファイルは削除され、FEから再度ダウンロードされます。BEが再起動すると、ダウンロードしたファイルがメモリにプリロードされます。