从Atlas BI Connector过渡到 MongoSQL

MongoDB建议从 Atlas BI Connector迁移到较新的SQL接口。

注意

Atlas BI Connector和本地部署BI Connector是独立的工具。本指南介绍从MongoDB正在逐步淘汰的Atlas BI Connector进行迁移。

MongoSQL

与Atlas BI Connector类似，MongoSQL 使您能够使用各种基于SQL的工具（例如Tableau和 Power BI）分析来自Atlas集群的数据。

与Atlas BI Connector相比，MongoSQL 具有以下优势：

您可以使用Atlas Data Federation基础架构从Atlas集群以外的来源读取数据。
您可以设立模式。
您只需为使用量付费；您不需要订阅。
您可以将自定义MongoDB连接器用于Tableau和 Power BI。

要学习；了解有关 MongoDB 的更多信息，请参阅使用SQL接口进行查询。

MongoSQL 限制

MongoSQL 为只读。
MongoSQL 仅与SQL 92 方言兼容；不支持其他SQL方言。
所有Atlas Data Federation限制都应用于 MongoSQL，因为它是Atlas Data Federation的一项功能。

MongoSQL 定价

MongoSQL 仅产生Atlas Data Federation查询费用和 AWS 传输费用； SQL接口本身可免费使用。要详细学习；了解查询联合数据库实例的费用，请参阅Data Federation成本。

注意

MongoSQL 查询产生的费用显示在您查询的联合数据库实例下的发票上，作为“已处理的数据”或“返回和传输的数据”费用。

准备过渡到 MongoDB

要从Atlas BI Connector过渡到 MongoSQL，请确保您的部署满足以下先决条件：

此外， MongoDB建议您生成过渡就绪报告以帮助规划过渡。

先决条件

包含可查询数据的联合数据库实例。
用于连接到联合数据库实例的MongoDB 数据库用户。

生成过渡就绪报告

MongoDB提供了 MongoSQL 过渡准备工具来帮助您规划从Atlas BI Connector到SQL接口的迁移。该工具根据您过去的Atlas BI Connector使用情况生成一份报告，提供实时模式分析和建议，并突出显示需要更改语法才能使用 MongoSQL 正常运行的查询。

要生成报告，您必须至少向该工具提供以下详细信息之一：

您的Atlas BI Connector日志，用于查询分析。
您的集群URI ，用于模式分析。

您可以分析查询和/或模式。

下载 MongoSQL 就绪报告工具。

选择下面适合您操作系统的标签页并下载可执行文件。

下载MongoDB MongoSQL 就绪报告工具。

向就绪报告工具授予执行权限。

如果该文件还没有执行权限，请授予该权限。

 chmod +x <executable-filename>

 chmod +x <executable-filename>

 chmod +x <executable-filename>

（可选）下载并解压缩Atlas BI Connector日志。

提供Atlas BI Connector日志后，准备情况报告工具就能报告以下信息：

历史查询数据，例如数量和频率。
在 MongoSQL 中会失败的查询语法。
具有关系数据库未知数据类型的集合字段。

要下载您的 Atlas BI Connector 日志，请执行以下操作：

在 Atlas 用户界面中，转到具有要分析的 BI 连接的 Atlas 集群。
从集群的选项（），选择 Download Logs 。
下载 mongosql.gz 。
创建一个新目录，然后将mongosql.gz解压缩到其中。

（可选）复制集群URI。

提供Atlas 集群URI可以让就绪报告工具分析您的集合模式并识别包含SQL工具未知数据类型的字段。

要查找集群URI ，请执行以下操作：

在 Atlas 用户界面中，请前往包含您想要分析的集合的集群。
单击 Connect（连接）。
从连接选项列表中选择 Shell。
仅复制您的连接URI 。
连接URI类似于： mongodb+srv://bicluster.example.mongodb.net/ 。排除shell可执行文件 mongosh 和任何特定于shell的命令行选项。

生成报告。

在终端中，运行准备情况报告工具可执行文件，提供您下载的日志或集群 URI。

必须包含数据库用户名。
您必须包含--input和/或--uri 。如果包含URI ，就绪报告工具会提示您输入数据库用户密码。
您可以为生成的报告指定 --output 目的地。如未指定，它将在当前目录中生成。
您可以指定--resolver来为网络请求选择DNS解析程序。可能的值为： cloudflare 、 google和quad9 。
您可以使用--include或--exclude来缩小命名空间列表的范围。支持 Global 语法。默认，包括所有命名空间。

--help选项返回就绪报告工具选项的完整列表：

<executable-filename> --help
Options:
     -i, --input <INPUT>        Sets the input file or directory to analyze BIC logs (optional). One of `--input` or `--uri` must be provided, or both
     -o, --output <OUTPUT>      Sets the output directory (optional). If not specified, the current directory is used
         --uri <URI>            The Atlas cluster URI to analyze schema (optional). One of `--input` or `--uri` must be provided, or both
     -u, --username <USERNAME>  Username for authentication (optional). This is required if the username and password is not provided in the URI
         --quiet                Enables quiet mode for less output
         --resolver <RESOLVER>  The specified resolver (optional) [possible values: cloudflare, google, quad9]
         --include <INCLUDE>    A list of namespaces to include (optional). If not provided, all namespaces are included. Glob syntax is supported
         --exclude <EXCLUDE>    A list of namespaces to exclude (optional). If not provided, no namespaces are excluded
     -h, --help                 Print help (see more with '--help')
     -V, --version              Print version

就绪报告工具会组织输出并生成可点击的索引文件，以便您可以轻松浏览报告。

过渡到 MongoDB

MongoSQL 的根本的架构与Atlas BI Connector不同，您可能需要调整模式或查询。

要过渡到 MongoSQL，请确定在 MongoSQL 上失败的现有Atlas BI Connector查询，并更新模式或语法来修复这些查询。

警告

MongoDB建议在对生产环境进行更改之前在沙盒环境中测试完整的过渡进程。从Atlas BI Connector过渡到 MongoSQL 而不调整模式或查询，可能会导致重大更改。

为联合数据库实例启用 MongoSQL。

要学习；了解有关启用和使用 MongoSQL 的更多信息，请参阅启用SQL接口。

使用SQL接口连接到您的数据。

要学习；了解有关使用 MongoSQL 连接的更多信息，请参阅使用Atlas SQL接口进行连接。

测试您的查询。

使用新的 MongoSQL 连接测试查询，确保查询运行并返回预期的结果。

要学习；了解有关使用 MongoSQL 进行查询的更多信息，请参阅使用 MongoSQL 语句进行查询。

查看您的模式并根据需要进行调整。

要学习；了解有关 MongoDB 中模式的更多信息，请参阅模式管理。

调整任何失败的查询。

从Atlas BI Connector过渡到 MongoSQL 时，某些查询语法可能需要更改。

要学习；了解有关 MongoSQL查询语法的更多信息，请参阅 MongoSQL 语言参考。

MongoDB 故障排除

以下MongoDB资源可以帮助您对 MongoSQL 配置进行故障排除：

后退

启用SQL访问

来年

连接