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

マネージドボリューム

リージョンでの提供状況

この機能は、すべての AWS および Google Cloud リージョンで利用できます。Azure でマネージドボリュームを使用するには、お問い合わせください。

マネージドボリュームは、インポートおよび移行で使用するデータファイルを保持するための、Zilliz Cloud ホスト型オブジェクトストアです。このページでは、Web コンソールおよび SDK を使用してマネージドボリュームを作成、管理、削除する方法について説明します。

考慮事項​

  • ボリュームは、プロジェクトのクラウドプロバイダーとリージョンに制限されます。たとえば、プロジェクトが AWS us-west-2 にある場合、ボリュームは AWS us-west-2 でのみ作成できます。

  • クラスターでボリュームを使用するには、クラスターがボリュームと同じクラウドプロバイダーおよびリージョンにある必要があります。

  • ボリュームを作成および管理するには、Project Admin である必要があります。

  • ボリュームの構成は、作成後に編集できません。ボリューム設定を変更する場合は、目的の設定で新しいボリュームを作成してください。

  • 各組織は、最大 100 個のマネージドボリュームを作成できます。

事前準備​

SDK 経由でボリュームを作成および管理する必要がある場合は、まずボリュームマネージャーを初期化する必要があります。

ボリュームマネージャーは、Zilliz Cloud のボリュームサービスへの接続を維持します。ボリュームを管理する前に、ボリュームマネージャーを初期化する必要があります。

python
from pymilvus.bulk_writer.volume_manager import VolumeManager

volume_manager = VolumeManager(
    cloud_endpoint="https://api.cloud.zilliz.com",
    api_key="YOUR_API_KEY"
)

マネージドボリュームを作成する​

ボリュームは、Web コンソールまたは SDK 経由で作成できます。

  • Via SDKs

    ボリュームは Zilliz Cloud プロジェクトに固有です。ボリュームを作成する際は、プロジェクト ID、リージョン ID、およびボリューム名を次のように指定する必要があります：

    python
    from pymilvus.bulk_writer.volume_manager import VolumeManager

    # Initiate a volume manager

    volume_manager = VolumeManager(
        cloud_endpoint="https://api.cloud.zilliz.com",
        api_key="YOUR_API_KEY"
    )

    volume_name = "managed_volume"

    # Create a managed volume
    volume_manager.create_volume(
        project_id="proj-xxxxxxxxxxxxxxxxxxxxxxx",
        region_id="aws-us-west-2",
        volume_name=volume_name
    )

    print(f"\nVolume {volume_name} created")

    # Volume managed_volume created

    次の表は、パラメーターについて説明しています。

    パラメーター説明
    projectIdボリュームを作成するプロジェクトの ID です。
    regionId作成するボリュームのリージョンは、データのインポートまたは移行先となるターゲットクラスターのクラウドプロバイダーおよびリージョンと一致する必要があります。
    volumeName作成するボリュームの名前は組織内で一意である必要があり、64 文字以下で、英字またはアンダースコアで始まり、英字、数字、ハイフン、およびアンダースコアのみを含む必要があります。
    type(optional)オプション：MANAGED、EXTERNAL
    このパラメーターを省略した場合、デフォルトでマネージドクラスターが作成されます。
    description(optional)作成するボリュームの説明です。最大 255 文字です。

  • Via web console

    1

    左側のナビゲーションで Volumes をクリックします。

    2

    ボリュームページで + Volume をクリックします。

    3

    ボリュームの構成を設定します。

    次の表は、マネージドボリュームの作成時に使用する各パラメーターについて説明しています。

    パラメーター

    説明

    名前

    ボリューム名は組織内で一意である必要があり、64 文字以下で、英字またはアンダースコアで始まり、英字、数字、ハイフン、およびアンダースコアのみを含む必要があります。

    説明（オプション）

    このパラメーターはオプションです。最大 255 文字です。

    ボリュームタイプ

    ボリュームタイプとして「Managed」を選択します。

    請求タイプ

    • マネージドボリューム機能を試すだけの場合は、無料トライアルボリュームを作成します。無料トライアルボリュームは組織ごとに 1 回のみ作成でき、容量とファイルアップロードに制限があります。詳細については、請求セクションの比較表を参照してください。

    • 本番ワークロードには、従量課金ボリュームを作成します。

    クラウドプロバイダーとリージョン

    ボリュームのクラウドプロバイダーおよびリージョンは、データのインポートまたは移行先となるターゲットクラスターのクラウドプロバイダーおよびリージョンと一致する必要があります。

    4

    Create をクリックします。

マネージドボリュームを一覧表示する​

プロジェクト内の既存のすべてのボリュームを表示できます。

  • Via SDKs

    python
    # Initiate a volume manager

    volume_manager = VolumeManager(
        cloud_endpoint="https://api.cloud.zilliz.com",
        api_key="YOUR_API_KEY"
    )

    # List volumes
    volume_list = volume_manager.list_volumes(
        project_id="proj-xxxxxxxxxxxxxxxxxxxxxxx",
        current_page=1,
        page_size=10
    )

    print("\nlistVolumes results:\n", volume_list.json()["data"])

  • Via web console

    Hp1Hwxoj9hkJqdbECCYcB4G6nVe

マネージドボリュームの詳細を表示する​

特定のマネージドボリュームの詳細も確認できます。

  • Via SDKs

    python
    # Initiate a volume manager

    volume_manager = VolumeManager(
        cloud_endpoint="https://api.cloud.zilliz.com",
        api_key="YOUR_API_KEY"
    )

    volume_name = "managed_volume"

    # Describe a volume
    volume_info = volume_manager.describe_volume(
        volume_name=volume_name
    )

    print("\ndescribeVolume result:\n", volume_info.json()["data"])

    # describeVolume result:
    # {
    #     "volumeName": "managed_volume",
    #     "type": "MANAGED",
    #     "regionId": "aws-us-west-2",
    #     "status": "RUNNING",
    #     "createTime": "2026-05-06T02:24:26Z"
    # }

  • Via web console

    プロジェクト内のボリュームの一覧を表示し、ボリューム名をクリックすると特定のボリュームの詳細を確認できます。

    FU4ow2zIuht0CfbRiBJcFZ6RnYf

マネージドボリュームにデータをアップロードする​

現在、データファイルまたはフォルダーをマネージドボリュームにアップロードできるのは、SDK 経由のみです。

  1. ボリュームファイルマネージャーを初期化する

    ボリュームファイルマネージャーは、Zilliz Cloud のボリュームサービス上の特定のボリュームへの接続を維持します。ボリュームにファイルをアップロードする前に、ボリュームファイルマネージャーを初期化する必要があります。

    python
    from pymilvus.bulk_writer.volume_file_manager import VolumeFileManager

    volume_file_manager = VolumeFileManager(
        cloud_endpoint='https://api.cloud.zilliz.com',
        api_key='YOUR_API_KEY',
        volume_name='managed_volume',
    )

  2. ファイルまたはフォルダーをアップロードする

    ボリュームファイルマネージャーの準備ができたら、それを使用してファイルまたはフォルダーを指定されたマネージドボリュームにアップロードします。

    • ファイルをアップロードする

      次の例では、ソースファイルパスのローカルファイルを、ボリューム内のターゲットファイルパスにアップロードします。

      python
      result = volume_file_manager.upload_file_to_volume(
          source_file_path="/path/to/your/local/data/file", 
          target_volume_path="data/"
      )

      print(f"\nuploadFileToVolume results: {result}")

      # uploadFileToVolume results: 
      # 
      # {
      #     "volumeName": "managed_volume",
      #     "path": "data/"
      # }

    • フォルダーをアップロードする

      次の例では、ソースファイルパスのローカルファイルを、ボリューム内のターゲットファイルパスにアップロードします。

      python
      result = volume_file_manager.upload_file_to_volume(
          source_file_path="/path/to/your/local/data/folder/",
          target_volume_path="data/"
      )

      print(f"\nuploadFileToVolume results: {result}")

      # uploadFileToVolume results:
      #
      # {
      #     "volumeName": "managed_volume",
      #     "path": "data/"
      # }

マネージドボリュームからデータを削除する​

マネージドボリュームからデータを削除するには、ファイルまたはフォルダーのサイズによっては数分かかる場合があります。

Warning

削除したファイルおよびフォルダーは復元できません。注意して操作してください。

現在、マネージドボリュームからデータを削除できるのは、Web コンソール経由のみです。

1

左側のナビゲーションで Volumes をクリックします。

2

Files タブに切り替えます。

3

Actions 列で ... をクリックし、続いて Delete をクリックします。

マネージドボリュームを削除する​

不要になったマネージドボリュームは、いつでも削除できます。無料トライアルボリュームは組織ごとに 1 回しか作成できないことに注意してください。一度削除すると、無料トライアルボリュームは作成できなくなります。

マネージドボリュームを削除すると、そのすべてのファイルとフォルダーも削除されます。

Warning

削除したボリュームは復元できません。注意して操作してください。

  • Via SDKs

    次のようにしてマネージドボリュームを削除できます：

    python
    # Initiate a volume manager

    volume_manager = VolumeManager(
        cloud_endpoint="https://api.cloud.zilliz.com",
        api_key="YOUR_API_KEY"
    )

    volume_name = "managed_volume"

    # Delete a volume
    volume_manager.delete_volume(
        volume_name=volume_name
    )

    print(f"\nVolume {volume_name} deleted")

    # Volume managed_volume deleted

  • Via web console

    1

    左側のナビゲーションで Volumes をクリックします。

    2

    Actions 列で ... をクリックし、続いて Delete を選択します。

    3

    ボリューム名を入力し、Delete をクリックします。

請求​

マネージドボリュームを作成する際は、無料トライアルまたは従量課金プランのいずれかを選択できます。次の表では、それぞれの一般的なユースケースと制限を比較しています。

無料トライアル従量課金
ユースケーステスト環境専用です。本番環境で使用します。
容量5 GB無制限
アップロードごとのファイルサイズと数各アップロードで最大 1 GB のデータ、最大 1,000 ファイル各アップロードで最大 100 GB のデータ、ファイル数は無制限
最大ボリューム数1100

無料トライアルボリューム

  • 支払い方法は不要です。

  • 各組織に作成できる無料トライアルボリュームは 1 つのみです。

  • 無料トライアルボリュームは 30 日間保持され、その後自動的に削除されます。

従量課金ボリューム

  • 有効な支払い方法が必要です。

  • 従量課金ボリュームを使用すると料金が発生します。

    • マネージドボリュームが利用可能な場合にのみ料金が発生します。

    • 料金表については、料金ガイド を参照してください。

    • ボリュームの料金がどのように計算されるかについては、ストレージコスト を参照してください。

よくある質問​

請求書の支払延滞により組織が凍結された場合、ボリュームはどうなりますか？

組織が凍結されると、すべてのマネージドボリューム（無料トライアルと従量課金の両方）およびそこに保存されているすべてのファイルが削除され、復元できなくなります。外部ボリュームも凍結され、新しい操作には使用できなくなりますが、独自のバケット内のデータは影響を受けません。

ボリュームの使用を継続するには、まず未払いの請求書をすべて決済してください。

Web コンソールに無料トライアルボリュームのオプションが表示されないのはなぜですか？

組織で無料トライアルボリュームが作成されると、無料トライアルボリュームのオプションは非表示になります。各組織で作成できる無料トライアルボリュームは 1 つのみです。

ボリュームのステータスにはどのような意味がありますか？

次の表は、考えられるボリュームのステータスを示しています。

ステータス説明
Availableボリュームは有効で、使用可能です。
Frozen組織が 請求書 の支払延滞により凍結されています。ボリュームは新しい操作に使用できません。ボリュームの使用を継続するには、請求額をお支払いください。
このページは役に立ちましたか？
Ctrl I