Skip to main content

Create a Milvus or Zilliz Cloud Data Source

Add a Milvus or Zilliz Cloud data source to NineData for supported Database DevOps, backup and restore, data replication, database comparison, and other workflows. This guide covers connection mode, credentials, SSL settings, environment settings, and the connection test.

Before you begin

  • The server IP address of NineData has been added to the data source allowlist. The server IP address can be viewed by selecting the target region in Access Region on the Create Datasource page.

    server_ip_address

  • Make sure data source quota is available; otherwise, the data source cannot be added. Check the remaining quota in the NineData Console header.check_quota

Procedure

  1. Sign in to the NineData Console.

  2. On the left navigation pane, click Datasource > Datasource.

  3. Select the Datasource tab, and then select Create Datasource. In the data source type selector, choose Database > (the type of data source to be added). On the Create Datasource page, configure the parameters based on the table below.
    tip

    If you make a mistake during the operation, select the arrow_down icon at the top of the Create Datasource page and choose again.

  1. Configure the data source parameters:

    Parameter
    Description
    NameEnter a data source name. Use a meaningful name so it is easy to find and manage later.
    ConnectionSelect how NineData connects to the data source. Supported methods are IP Address, Gateway, and SSH Tunnel.
    • IP Address: Connect through the public network address.
    • Gateway (Sentinel and Cluster Mode are currently not supported): Use a NineData gateway for private-network access. Connect the host that runs the data source first. For instructions, see Add Gateway.
    • SSH Tunnel (Sentinel and Cluster Mode are currently not supported): Connect through an SSH tunnel.
    Configuration items when Connection is IP AddressHost: Enter the public connection address and port of the data source.
    For Zilliz Cloud, enter the connection address without https and set the port to 443.
    Note: Zilliz Cloud supports only IP Address.
    Configuration items when Connection is Gateway
    • Gateway: Select the NineData gateway installed on the host where the data source is located.
    • Host: Enter localhost if the data source is on the same host as the gateway, or enter the internal IP address of the host where the data source is located.
    Configuration items when Connection is SSH Tunnel
    • SSH Host: Enter the public IP address or domain name and SSH port of the server where the target data source is located. The default SSH port is 22.
    • SSH Authentication Method: Select the SSH authentication method.
      • Password: Connect with SSH Username and Password.
        • SSH Username: Enter the login username of the server where the target data source is located.
        • Password: Enter the login password of the server where the target data source is located.
      • Key (recommended): Connect with SSH Username and Key File.
        • SSH Username: Enter the login username of the server where the target data source is located.
        • Key File: Click Upload to upload the private key file, which is a key file without a suffix. If you have not created one yet, see Generate SSH Tunnel Key File.
        • Password: Enter the password set when the key file was generated. If no password was set during key generation, leave this field blank.
    • Note: After configuring SSH, click Connection Test to test the tunnel. Possible results:
      • Connection Successfully: The SSH tunnel is established.
      • Error message: The connection failed. Troubleshoot the cause based on the error details and try again.
    • Host: Enter localhost if the data source is on the same host as the SSH server, or enter the internal IP address of the host where the data source is located.
    DB AccountEnter the data source username. Leave this field empty if authentication is not required.
    For Zilliz Cloud, enter any character.
    DB PasswordEnter the data source password. Leave this field empty if authentication is not required.
    For Zilliz Cloud, enter the Zilliz Cloud data source token.
    Access RegionSelect the region closest to the data source to help reduce network latency.
    EnvironmentChoose an environment based on the business purpose of the data source. This serves as an environment identifier of the data source. Default provides PROD and DEV environments, and supports you to create a custom environment.
    Note: Under organization mode, the database environment can also be applied to permission policy management. For example, the default Prod Admin role can access only data sources in the PROD environment and cannot access data sources in other environments. For more information, see Manage Roles.
    SSLConfigure SSL encryption for the data source. This option is disabled by default. If the data source requires SSL-encrypted connections, enable this option. For Zilliz Cloud, SSL encryption must be enabled.
    Use the switch on the right to turn encrypted transmission on or off. Click > to the left of Encryption to expand the detailed configuration.
    • SSL Options: Supports the following methods.
      • If Available: Detect the server SSL status automatically. If SSL is enabled on the server, NineData connects through SSL first. If SSL is not enabled, NineData uses a non-SSL connection.
      • Require: Always use SSL to connect to the data source. If the server does not support SSL or the SSL connection cannot be established for another reason, the connection fails.
    • Verify Server Certificate (SSL CA): If the server uses a certificate issued by a self-signed CA, upload the root certificate of the CA here.
    • Verify Server Identity (SSL Identify): Verify the server name, IP address, and other identity information to help prevent man-in-the-middle attacks.
    • Authenticate Client: If the server requires a client certificate, upload the client certificate and key here. The server verifies the uploaded information before accepting the connection.
  2. After you configure all parameters, click Connection Test next to Create Datasource to test connectivity. When Connection Successfully is displayed, click Create Datasource to create the data source. Otherwise, review the connection settings and run the test again.

Result

After the connection test succeeds and you create the data source, it appears in the data source list. Use it in NineData features that support Milvus or Zilliz Cloud.