从 Atlas BI Connector 过渡到 Atlas SQL

在此页面上

Atlas SQL

Atlas SQL 限制
Atlas SQL定价
准备过渡到Atlas SQL
过渡到 Atlas SQL
Atlas SQL故障排除

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

注意

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

Atlas SQL

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

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

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

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

Atlas SQL 限制

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

Atlas SQL定价

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

注意

Atlas SQL 查询所产生的费用会显示在您查询的联邦数据库实例的发票上，作为“处理的数据”或“返回和传输的数据”费用。

准备过渡到Atlas SQL

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

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

先决条件

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

生成过渡就绪报告

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

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

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

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

下载Atlas SQL就绪报告工具。

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

下载 MongoDB Atlas SQL就绪报告工具。

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

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

 chmod +x <executable-filename>

 chmod +x <executable-filename>

 chmod +x <executable-filename>

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

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

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

要下载您的 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

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

过渡到 Atlas SQL

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

要过渡到Atlas SQL ，请识别在Atlas SQL上失败的现有Atlas BI Connector查询，并更新模式或其语法来修复它们。

警告

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

为联合数据库实例启用 Atlas SQL。

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

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

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

测试您的查询。

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

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

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

如要进一步了解 Atlas SQL 中的模式，请参阅模式管理。

调整任何失败的查询。

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

如要了解有关 Atlas SQL 查询语法的更多信息，请参阅 Atlas SQL 语言参考。

Atlas SQL故障排除

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

后退

BI Connector

来年

系统 DSN