帮你快速理解、总结文档立即下载

快速入门

最近更新时间:2026-10-16 11:30:00
我的收藏
本文为您介绍快速创建并连接 TDSQL Nexa 实例的完整流程:从账号与网络准备,到在控制台创建实例(含引擎选型)、通过客户端连接实例,再到首次数据操作体验,帮助您在短时间内搭建基础环境并验证 Nexa 多引擎融合的核心能力。
说明:
Nexa 当前处于邀测阶段,仅受邀用户可在控制台体验创建与使用,且仅开放免费试用计费模式,不产生产品费用。正式计费模式将随产品发布一并公布。

操作流程

步骤
说明
完成账号注册、实名认证、试用资格确认与网络规划。
在控制台创建 Nexa 实例,完成地域、网络、引擎选型与规格配置。
在引擎管理中获取目标引擎的连接信息,通过客户端连接实例。
在实例中执行基本数据操作,验证各引擎的读写与检索能力正常。

准备工作

开始操作前,请确认已完成以下准备:
1. 注册账号:注册 腾讯云账号 并完成 实名认证。
2. 确认试用资格:Nexa 当前处于邀测阶段,需先通过 腾讯云团队 开通使用资格,才能在控制台创建实例。
3. 网络规划:已规划好 VPC 与子网,并确认子网剩余 IP 数量满足实例创建需求。

步骤一:创建实例

规格与参数规划

创建实例前,建议先根据业务需要规划以下参数:
参数
说明
选择建议
计费模式
邀测期间仅开放免费试用,按量计费 / 包年包月本期暂不开放。
直接选择免费试用即可体验完整能力。
地域 / 可用区
实例所在的物理位置,当前仅支持单可用区部署。
选择与业务服务器相同的地域与可用区,降低网络延迟。
引擎类型
Nexa 核心引擎为必选且无法取消;可按需加购搜索引擎、分析引擎,支持多选组合。
向量/全文检索、RAG 场景选搜索引擎;OLAP 分析、实时看板选分析引擎。多引擎可同时勾选,各自独立计费。
实例规格
各引擎的 CPU 与内存为固定搭配套餐,具体可选规格档位以控制台实际展示为准,暂不支持自由组合。
开发测试等轻量场景可选较小规格快速验证;生产场景按业务并发量与数据规模选择,后续可按需调整。
节点数
各引擎独立配置节点数(副本数,1 ~ 10)。Nexa 核心引擎节点数 > 1 时,实例整体进入高可用部署形态,此时其他已勾选引擎节点数需同步 ≥ 2。
生产环境建议 Nexa 核心引擎节点数 ≥ 2 构建高可用;开发测试可保持单节点。
存储空间
各引擎独立配置存储空间,支持在合法区间内动态调节。
按业务数据量预留一定余量,后续可按需调整。

操作步骤

1. 登录 TDSQL Nexa 控制台,进入实例列表页。
2. 单击新建实例,进入创建页面。
3. 选择计费模式:免费试用。
4. 选择地域与可用区。
5. 勾选所需引擎类型:Nexa 核心引擎默认必选;如需 AI 检索或 OLAP 分析能力,勾选对应的搜索引擎 / 分析引擎。
6. 为每种已勾选的引擎分别配置实例规格、节点数与存储空间。
7. 选择私有网络(VPC)与子网。
8. 设置实例名称,并配置 root 密码。密码需8 - 64位,且包含大小写字母和数字,请勿写入代码仓库,统一通过环境变量或密钥管理服务保存。
9. 核对购买数量(免费试用限1台)与费用预估信息无误后,提交创建。
10. 等待实例状态变为运行中,即实例创建成功。
创建完成后,建议进行以下检查,确保实例处于可用状态:
实例状态为运行中。
所需引擎均已开通,可在实例详情页引擎管理 Tab 中确认各引擎状态。
当前版本仅支持内网访问,请确认业务所在网络与实例处于同一 VPC,或已打通网络连接。

步骤二:连接实例

连接前准备

1. 获取访问地址:进入实例详情页引擎管理 Tab,找到目标引擎,单击连接示例,在弹窗中查看该引擎支持的接入协议与访问地址(部分协议默认不开启,可在弹窗中按需开启)。
2. 确认网络访问:当前版本仅支持内网访问,请确保客户端所在网络与实例处于同一 VPC 内,或已通过其他方式打通内网连接。
3. 准备账号密码:使用创建实例时设置的 root 账号与密码。如需为业务分配独立账号,可前往账号管理 Tab 创建账号并设置主机、连接数限制与过期时间。

执行连接

使用您熟悉的数据库客户端或应用程序,通过上一步获取的访问地址、账号与密码连接目标引擎。其中 Nexa 核心引擎兼容标准 MySQL 协议,可直接使用现有 MySQL 客户端连接;搜索引擎可使用 OpenSearch 客户端 / SDK 接入;分析引擎同样兼容 MySQL 协议,可直连执行 OLAP 查询。连接成功后,即可对实例执行数据操作。
注意:
连接过程中请遵循以下安全实践,保障实例与数据安全:
凭据仅通过环境变量或密钥管理服务下发,避免硬编码在代码中或提交到版本库。
拼接 SQL 时使用参数绑定,避免 SQL 注入。
当前版本仅支持内网访问,请确保业务已部署在与实例同一 VPC 内。
为应用分配专用账号,按最小权限原则授予库表权限,并合理设置过期时间。

步骤三:简单使用体验

连接成功后,您可以按以下方式快速体验 Nexa 多引擎融合的核心能力:
1. 连接 Nexa 核心引擎,创建数据库与数据表并写入业务数据,执行查询验证标准 MySQL 协议下的读写能力。
-- 使用 MySQL 标准语法创建表结构示例
mysql> CREATE TABLE t1(c1 int, c2 int, c3 int);
Query OK, 0 rows affected (0.08 sec)

-- 使用 MySQL 标准语法写入数据示例
mysql> INSERT INTO t1 VALUES (1, 1, 1), (2, 2, 2), (3, 3, 3);
Query OK, 3 rows affected (0.03 sec)

-- 使用 MySQL 标准语法进行数据的查询示例
mysql> SELECT * FROM t1;
+------+------+------+
| c1 | c2 | c3 |
+------+------+------+
| 1 | 1 | 1 |
| 2 | 2 | 2 |
| 3 | 3 | 3 |
+------+------+------+
3 rows in set (0.02 sec)
2. 如已开通搜索引擎,可通过 OpenSearch RESTful 接口体验向量检索、全文检索与多模态数据召回能力。
# 使用标准的 OpenSearch API 接口进行数据检索,如 match 全文检索示例和向量检索示例
curl -X POST "http://opensearch-host:9200/my_index/_search?size=10" \\
-u "admin:password" \\
-H "Accept: application/json" \\
-H "Content-Type: application/json" \\
-d '{
"query": {
"match": { "name": "Alice" }
}
}'

curl -X POST "http://opensearch-host:9200/my_index/_search?size=10" \\
-u "admin:password" \\
-H "Accept: application/json" \\
-H "Content-Type: application/json" \\
-d '{
"query": {
"knn": {
"embedding": {
"vector": [0.12, -0.03, 0.45, 0.88, 0.21],
"k": 10
}
}
}
}'
3. 如已开通分析引擎,可执行 OLAP 聚合查询,体验列式存储与实时分析能力。
-- 使用标准的 MySQL 语法进行复杂分析查询,如 TPC-H Q1 示例(SF=100G)
mysql> SELECT
-> l_returnflag,
-> l_linestatus,
-> SUM(l_quantity) AS sum_qty,
-> SUM(l_extendedprice) AS sum_base_price,
-> SUM(l_extendedprice * (1 - l_discount)) AS sum_disc_price,
-> SUM(l_extendedprice * (1 - l_discount) * (1 + l_tax)) AS sum_charge,
-> AVG(l_quantity) AS avg_qty,
-> AVG(l_extendedprice) AS avg_price,
-> AVG(l_discount) AS avg_disc,
-> COUNT(*) AS count_order
-> FROM lineitem
-> WHERE l_shipdate <= DATE '1998-12-01' - INTERVAL '90' DAY
-> GROUP BY l_returnflag, l_linestatus
-> ORDER BY l_returnflag, l_linestatus;
+--------------+--------------+---------------+-------------------+---------------------+-----------------------+--------------------+--------------------+----------------------+-------------+
| l_returnflag | l_linestatus | sum_qty | sum_base_price | sum_disc_price | sum_charge | avg_qty | avg_price | avg_disc | count_order |
+--------------+--------------+---------------+-------------------+---------------------+-----------------------+--------------------+--------------------+----------------------+-------------+
| A | F | 3775127758.00 | 5660776097194.45 | 5377736398183.9374 | 5592847429515.927026 | 25.499370423275426 | 38236.11698430489 | 0.050002243530929025 | 148047881 |
| N | F | 98553062.00 | 147771098385.98 | 140384965965.0348 | 145999793032.775829 | 25.501556956882876 | 38237.1993888045 | 0.04998528433805397 | 3864590 |
| N | O | 7436302976.00 | 11150725681373.59 | 10593195308234.8523 | 11016932248183.655467 | 25.500009404374193 | 38237.227646360945| 0.04999791831562552 | 291619617 |
| R | F | 3775724970.00 | 5661603032745.34 | 5378513563915.4097 | 5593662252666.916161 | 25.50006628406532 | 38236.697258452965| 0.05000130433965413 | 148067261 |
+--------------+--------------+---------------+-------------------+---------------------+-----------------------+--------------------+--------------------+----------------------+-------------+
4 rows in set (0.123 sec)
4. 体验跨引擎混合查询:业务侧可统一连接 Nexa 核心引擎地址,由其智能编排与路由能力自动识别查询语义并分发至对应引擎,无需业务端区分实际连接目标。
-- 使用 MySQL 兼容协议 + Nexa 联邦扩展语法:在搜索引擎全文检索 "wireless" 相关商品 → 到分析引擎聚合明细算收入 → 到核心引擎取实时订单状态,一次 SQL 完成三引擎协同
mysql> SELECT
-> o.order_id,
-> o.status,
-> p.title,
-> p.category,
-> SUM(li.quantity) AS qty,
-> SUM(li.price * li.quantity * (1 - li.discount)) AS revenue,
-> p._score
-> FROM analyze_engine.main.lineitem li
-> JOIN mysql_engine.shop.orders o
-> ON o.order_id = li.order_id
-> JOIN opensearch_query(
-> index := 'products',
-> catalog := 'search_engine',
-> query := '{"match": {"title": "wireless"}}'
-> ) p
-> ON p.product_id = li.product_id
-> WHERE o.order_date >= DATE '2026-09-01'
-> GROUP BY o.order_id, o.status, p.title, p.category, p._score
-> ORDER BY p._score DESC;
+----------+---------+-------------------------------+-------------+-----+----------+--------+
| order_id | status | title | category | qty | revenue | _score |
+----------+---------+-------------------------------+-------------+-----+----------+--------+
| 1001 | PAID | Wireless Mouse Pro | electronics | 2 | 1198.00 | 2.85 |
| 1001 | PAID | Wireless Mechanical Keyboard | electronics | 1 | 720.00 | 2.12 |
| 1004 | SHIPPED | Wireless Gaming Headset | electronics | 2 | 2400.00 | 1.98 |
+----------+---------+-------------------------------+-------------+-----+----------+--------+
3 rows in set (0.42 sec)

下一步

如需了解 Nexa 的产品定位、核心架构与多模态计算引擎,请参见 产品概述。
如需了解购买方式与计费说明,请参见 购买指南。
如需了解引擎管理、账号管理、参数配置、数据源接入等更多功能与进阶操作,请参见 操作指南。