Terraform Provider
Zilliz はフルマネージドの Milvus サービスを提供しており、セキュリティを考慮したベクトル検索アプリケーションのデプロイとスケーリングを効率化し、Zilliz Cloud が提供するクラウドインフラストラクチャとお客様自身のインフラストラクチャの両方を含む、複雑なインフラストラクチャの構築とメンテナンスの必要性を排除します。
Zilliz Cloud Terraform Provider は、オープンソースの Infrastructure as Code (IaC) ソリューションであり、Zilliz Cloud リソースを動的に構築、変更、バージョン管理できるようにします。使用前に、適切な権限を持つ Zilliz Cloud API キーなどの適切な認証情報を使用してプロバイダーを構成する必要があります。
Authentication
Terraform を使用したリソースのデプロイを開始する前に、Terraform を Zilliz Cloud プラットフォームで認証する必要があります。この Terraform プロバイダーでのクラウドプレーン操作を行う前に、適切な権限を持つ Zilliz Cloud API キーを使用して認証を完了する必要があります。Zilliz Cloud API キーを作成するには、以下の手順に従ってください。
Zilliz Cloud コンソールにサインインします。
上部ナビゲーションバーの右側で、APIキーs をクリックします。
APIキーs ページの右上隅にある + APIキー をクリックします。
表示される Create APIキー ダイアログボックスで、API キー名を入力し、アクセス権限を構成して、Create をクリックして API キーを生成します。
API キーの管理について詳しくは、APIキーs を参照してください。
データプレーン操作（コレクションの操作、検索、クエリなど）を実行するには、ターゲットクラスターのコロン区切りのユーザー名とパスワードを username:password の形式でクラスターアクセストークンとして使用する必要があります。
以下に示すリソースのうち、クラスター、ユーザーとロール、および BYOC プロジェクトのリソースには Zilliz Cloud API を使用してください。データベース、コレクションとエイリアス、パーティション、およびインデックスのリソースにはクラスターアクセストークンを使用してください。
Manageable リソース
現在、このプロバイダーを使用して以下のタイプのリソースを管理できます。
Clusters
Zilliz Cloud クラスター は、Zilliz Cloud 上で動作する Milvus インスタンスです。Zilliz Cloud はクラスターを Free、Serverless、Dedicated (Standard)、Dedicated (Enterprise)、および Bring Your Own Cloud (BYOC) などのさまざまなオファリングに分類しています。これらのオファリングの詳細については、Detailed Plan Comparison を参照してください。
Zilliz Cloud Terraform Provider を使用して、特定のオファリングのクラスターを作成および管理できます。詳細については、以下のチュートリアルを参照してください。
Terraform Provider を BYOC で使用する場合、専用クラスターと BYOC クラスタータイプのみがサポートされます。BYOC プロジェクトでは Free クラスターと Serverless クラスターの作成は利用できません。
データベース
Zilliz Cloud では、データベース はデータを整理および管理するための論理単位として機能します。これは専用クラスターでのみ利用可能です。クラスターの作成時に、デフォルトのデータベースが作成されます。Zilliz Cloud Terraform Provider を使用してデータベースを管理する方法の詳細については、以下のリソースとデータソースを参照してください。
Collection & エイリアスes
コレクション は、固定された列と可変な行を持つ2次元テーブルです。各列はフィールドを表し、各行はエンティティを表します。Zilliz Cloud Terraform Provider を使用してコレクションを管理する方法の詳細については、以下のリソースとデータソースを参照してください。
Partition
パーティションはコレクションのサブセットです。各パーティションは親コレクションと同じデータ構造を共有しますが、コレクション内のデータの一部のみを含みます。このページでは、パーティションの管理方法を理解するのに役立ちます。Zilliz Cloud Terraform Provider を使用してパーティションを管理する方法の詳細については、以下のリソースとデータソースを参照してください。
Index
Zilliz Cloud は AUTOINDEX を採用して、効率的な類似性検索を可能にしています。また、ベクトル埋め込み間の距離を測定するために、以下のメトリックタイプも提供しています: コサイン類似度 (COSINE)、ユークリッド距離 (L2)、内積 (IP)、JACCARD、および HAMMING。AUTOINDEX は、メタデータフィルタリングを高速化するためにスカラーフィールドにも適用されます。Zilliz Cloud Terraform Provider を使用してインデックスを管理する方法の詳細については、以下のリソースとデータソースを参照してください。
Users & ロールs
Zilliz Cloud では、クラスターユーザーを作成し、クラスターロールを割り当てて権限を定義することで、データセキュリティを実現できます。ユーザーは、適切に構成された認証情報を持つデータベースユーザーを表し、一連のロールが割り当てられます。一方、ロールは一連の権限をカプセル化し、ユーザーに割り当てることができるエンティティです。このセクションのリソースとデータソースを使用して、ロールベースのアクセス制御 (RBAC) を実装できます。詳細については、以下のリソースとデータソースを参照してください。
BYOC projects
Zilliz Cloud はまた、BYOC ソリューションを提供しており、組織が Zilliz Cloud のインフラストラクチャに依存するのではなく、独自のクラウドアカウントでアプリケーションとデータをホストできるようにします。BYOC ソリューションは、クロスアカウント権限を通じて Zilliz Cloud にインフラストラクチャリソースの管理を委任するかどうかに応じて、BYOC モードまたは BYOC-I モードのいずれかでデプロイできます。詳細については、BYOC Overview を参照してください。
Zilliz Cloud Terraform Provider を使用して、BYOC または BYOC-I プロジェクトを作成し、VPC 内に関連するデータプレーンリソースをデプロイできます。詳細については、以下のチュートリアルを参照してください。