Go back to the English version of the documentationMicrosoft Azure Cosmos DB 连接
Microsoft Azure Cosmos DB 连接
Last updated: 2024年11月28日
要在 Microsoft Azure Cosmos DB 中访问数据,请为其创建连接资产。
Azure Cosmos DB 是完全受管的 NoSQL 数据库服务。
创建与 Microsoft Azure Cosmos DB 的连接
要创建连接资产,您需要以下连接详细信息:
- 主机名
- 端口号
- 主密钥: Azure Cosmos 数据库主读写密钥
注:Entra ID 身份验证的前提条件:
Microsoft Entra ID 是一项基于云的身份和访问管理服务。 要获取 Entra ID 身份验证方法的连接值,请登录 Microsoft Azure 门户,然后转到您的存储帐户。 有关 Microsoft Entra ID 的信息,请参阅 What is Microsoft Entra ID?。
Entra ID 客户机密钥凭证
- 租户 ID :Microsoft Entra 租户 ID。 要查找租户 ID,请转到Microsoft Entra ID> 属性。 向下滚动到租户 ID场地。 有关详细信息,请参阅For more information, see如何查找你的 Microsoft Entra 租户 ID 。
- 客户 ID:授权访问 Microsoft Azure Cosmos DB 的客户 ID。 要查找应用程序的客户端 ID,请选择微软Entra ID 。 从应用程序注册,选择您的应用程序。 点击复制复制您的应用程序的客户端 ID。 有关详细信息,请参阅For more information, see注册 Microsoft Entra 应用并创建服务主体。
- 客户端秘密:与客户端 ID 关联的验证密钥,用于授权访问 Microsoft Azure Cosmos DB。 要查找应用程序的客户端机密,请选择微软Entra ID 。 从应用程序注册,选择您的应用程序。 去证书和机密 > 客户端机密。 点击复制复制现有的客户端机密或单击新客户机密创建一个新的客户端机密并复制它。 有关详细信息,请参阅For more information, see注册 Microsoft Entra 应用并创建服务主体。
- 存储帐户 URL :存储帐户URL。
Entra ID 用户名密码凭证
- 客户 ID:授权访问 Microsoft Azure Cosmos DB 的客户 ID。 要查找应用程序的客户端 ID,请选择微软Entra ID 。 从应用程序注册,选择您的应用程序。 点击复制复制您的应用程序的客户端 ID。 有关详细信息,请参阅For more information, see注册 Microsoft Entra 应用并创建服务主体。
- Username 和 Password:Microsoft Azure Cosmos DB 账户的用户名和密码。 您需要获得许可,才能在没有多因素身份验证的情况下访问。
- 存储帐户 URL :存储帐户URL。
对于 专用连接,要连接到未外部化到因特网的数据库 (例如,在防火墙后) ,必须设置 安全连接。
根据您在平台中的位置选择创建连接的方法
- 在项目中
- 单击 资产> 新资产> 连接到数据源。 请参阅将连接添加到项目。
- 在目录中
- 单击 添加到目录> 连接。 请参阅将连接资产添加到目录中。
- 在部署空间中
- 单击 导入资产> 数据访问> 连接。 请参阅 向部署空间添加数据资产。
- 在平台资产目录中
- 单击新建连接。 请参阅添加平台连接。
下一步:从连接添加数据资产
请参阅通过项目中的连接添加数据。
请参阅从目录中的连接添加数据。
您可以在何处使用此连接
您可以在以下工作空间和工具中使用 Microsoft Azure Cosmos DB 连接:
项目
- Data Refinerywatsonx.aiStudio 或IBM Knowledge Catalog
- DataStage (DataStage 服务)。 请参阅 连接到 DataStage中的数据源。
- Decision Optimization(watsonx.ai工作室和 "watsonx.ai运行时)
- 笔记本watsonx.aiStudio)。 单击 " 代码片段 " 窗格上的 读取数据 以获取连接凭证并将数据装入到数据结构中。 请参阅从数据源连接加载数据。
- SPSS Modelerwatsonx.aiStudio)
目录
Platform assets catalog
其他目录 (IBM Knowledge Catalog)
Azure Cosmos DB 设置
- 设置 Azure Cosmos DB:Azure 门户网站
- 安全访问 Azure Cosmos DB 中的数据:主密钥
限制
- 仅支持核心 (SQL) API。
- 使用 Entra ID 凭据与 Azure Cosmos DB 连接进行身份验证时,不支持创建或删除集合/容器。 只支持列出现有收藏集并对其进行更改。 有关详细信息,请参阅 Azure Cosmos DB 文档。
运行 SQL 语句
要确保 SQL 语句正确运行,请参阅 Azure Cosmos DB 文档 以获取正确的语法。
了解更多信息
父主题: 支持的连接