Create Global Cluster

This guide explains how to create a global cluster.

If you need to enable the global cluster feature for an existing cluster, see Manage Cluster.

📘Notes

This feature is available only to Dedicated clusters in a Business Critical project.

Before you start

Ensure you are a Project Admin.

Create a global cluster

Turn on the switch next to Global Cluster in Cluster Settings. A global cluster must have 1 primary cluster and 1 to 5 secondary cluster. The cloud provider, cluster type, number of query CU should be consistent with those of the primary cluster.

The following demo shows how to create a global cluster via the web console.

Zilliz Cloud initializes both the primary and secondary clusters. After initialization completes, starts replicating data from the primary cluster to each secondary cluster.

You can monitor the sync status and replication latency between the primary and secondary clusters on the Global Topology tab.

CF69bk0flo9BtoxdvJzcFWF7nxj

Connect to a global cluster

After your global cluster is running, connect to it using a global endpoint or public endpoint and an authentication token.

Global endpoint/Public Endpoint: You can obtain this on the Zilliz Cloud web console. Navigate to the Cluster Details page of the target cluster. On the Connect card, you can copy the global endpoint or public endpoint. To understand when to use which endpoint, see Global Cluster Explained.

📘Note
If you have configured a private endpoint, you can choose to disable the public endpoint and global endpoint for greater security. For details, see Manage internet access to your clusters.

Token: This token can be an API key or a cluster credential that consists of a username and password pair.

The following example shows how to connect to a cluster.

Python
Java
NodeJS

# Connect using a MilvusClient object
from pymilvus import MilvusClient
CLUSTER_ENDPOINT="YOUR_CLUSTER_ENDPOINT" # Set your cluster endpoint
TOKEN="YOUR_CLUSTER_TOKEN" # Set your token

# Initialize a MilvusClient instance
# Replace uri and token with your own
client = MilvusClient(
    uri=CLUSTER_ENDPOINT, # Cluster endpoint obtained from the console
    token=TOKEN # API key or a colon-separated cluster username and password
)

import io.milvus.v2.client.MilvusClientV2;
import io.milvus.v2.client.ConnectConfig;

String CLUSTER_ENDPOINT = "YOUR_CLUSTER_ENDPOINT";
String TOKEN = "YOUR_CLUSTER_TOKEN";

// 1. Connect to Milvus server
ConnectConfig connectConfig = ConnectConfig.builder()
    .uri(CLUSTER_ENDPOINT)
    .token(TOKEN)
    .build();

MilvusClientV2 client = new MilvusClientV2(connectConfig);

const { MilvusClient, DataType, sleep } = require("@zilliz/milvus2-sdk-node")

const address = "YOUR_CLUSTER_ENDPOINT"
const token = "YOUR_CLUSTER_TOKEN"

// 1. Connect to the cluster
const client = new MilvusClient({address, token})

Before you start​

Create a global cluster​

Connect to a global cluster​

Before you start

Create a global cluster

Connect to a global cluster