部署一个联合数据库实例。
本页介绍如何部署联合数据库实例来访问 HTTP数据存储中的数据。
必需的访问权限
要部署联合数据库实例,您必须对项目拥有 Project Owner
访问权限。 在部署联合数据库实例之前,具有Organization Owner
访问权限的用户必须将自己作为Project Owner
添加到项目中。
先决条件
在开始之前,您需要:
创建一个 MongoDB Atlas帐户(如果您还没有帐户)。
注意
如果您的文件格式为
CSV
或TSV
,则必须在数据中包含标题行。有关详细信息,请参阅 CSV 和 TSV。使您的数据存储可通过公共互联网访问。
重要
如果无法通过HTTPS访问您的HTTP数据存储,则必须使用 JSON Editor来配置您的数据存储。 在JSON配置中,必须将
stores.[n].allowInsecure
设置为true
。Atlas Data Federation 不支持需要身份验证的HTTP数据存储URL 。
步骤
要使用 Atlas CLI 创建新的 Data Federation 数据库,请运行以下命令:
atlas dataFederation create <name> [options]
要学习;了解有关命令语法和参数的更多信息,请参阅Atlas CLI AtlasdataFederation create 的 文档。
指定您的数据存储。
从Data Sources部分选择联合数据库实例的数据集。
单击Add Data Sources选择您的数据存储。
指定您的数据存储。
选择HTTP(S)可为可公开访问的HTTP和HTTPS URL中的数据配置联合数据库实例。
与
stores.[n].provider
JSON 配置设置对应。在HTTP(S) Store Name字段中输入HTTP数据存储的名称。
注意
数据存储的名称在联合数据库实例中必须是唯一的。
与
stores.[n].name
JSON 配置设置对应。输入存储数据的文件的可公开访问的URL 。
Atlas Data Federation支持JSON 、 BSON 、 逗号分隔值(CSV) 、 制表符分隔值(TSV)、 Avro(gzip 压缩或未压缩)、 Parquet 和 ORC文件类型。
提示
单击Use Sample URL添加示例HTTP数据存储。
对于要添加的每个其他HTTP数据存储,单击Add Another URL ,然后输入HTTP数据存储URL。
与
stores.[n].urls
JSON 配置设置对应。单击Next以配置虚拟数据库和collection。
创建虚拟数据库、集合和视图,并将数据库、集合和视图映射到数据存储。
(可选)单击对于:
数据库,用于编辑数据库名称。默认值为
VirtualDatabase[n]
。与
databases.[n].name
JSON 配置设置对应。集合,可编辑集合名称。 默认值为
VirtualCollection[n]
。与
databases.[n].collections.[n].name
JSON 配置设置对应。视图,用于编辑视图名称。
您可以单击:
从Data Sources部分的下拉列表中选择HTTP 。
拖放数据存储以与集合映射。
与
databases.[n].collections.[n].dataSources
JSON 配置设置对应。
HTTP数据存储的配置应如下所示:
1 { 2 "stores" : [ 3 { 4 "name" : "<string>", 5 "provider": "<string>", 6 "defaultFormat" : "<string>", 7 "allowInsecure": <boolean>, 8 "urls": ["<string>"] 9 } 10 ], 11 "databases" : [ 12 { 13 "name" : "<string>", 14 "collections" : [ 15 { 16 "name" : "<string>", 17 "dataSources" : [ 18 { 19 "storeName" : "<string>", 20 "allowInsecure" : <boolean>, 21 "urls" : ["<string>"], 22 "defaultFormat" : "<string>", 23 "provenanceFieldName": "<string>" 24 } 25 ] 26 } 27 ], 28 "views" : [ 29 { 30 "name" : "<string>", 31 "source" : "<string>", 32 "pipeline" : "<string>" 33 } 34 ] 35 } 36 ] 37 }
有关配置设置的更多信息,请参阅HTTP URL。
定义您的HTTP数据存储。
编辑
stores
用户界面中显示的JSON配置设置。 您的stores
配置设置应如下所示:"stores" : [ { "name" : "<string>", "provider" : "<string>", "allowInsecure": <boolean>, "urls" : ["<string>"], "defaultFormat" : "<string>" } ] 要学习;了解有关这些配置设置的更多信息,请参阅
stores
。定义联合数据库实例虚拟数据库、集合和视图。
编辑
databases
用户界面中显示的JSON配置设置。 您的databases
配置设置应如下所示:"databases" : [ { "name" : "<string>", "collections" : [ { "name" : "<string>", "dataSources" : [ { "storeName" : "<string>", "allowInsecure" : <boolean>, "urls" : ["<string>"], "defaultFormat" : "<string>", "provenanceFieldName": "<string>" } ] } ] } ] 要学习;了解有关这些配置设置的更多信息,请参阅
databases
。