如何使用Azure存储探索器管理Cosmos DB

1,826 阅读10分钟

本文将解释如何使用Azure存储资源管理器为Azure cosmos DB执行各种活动。存储资源管理器是一个非常有用的桌面工具,可以帮助管理员在不访问Azure门户的情况下管理Azure存储。我们也可以用这个工具连接到Azure Cosmos DB账户,但这个功能在将来会被废弃。从目前来看,它是被支持的,所以我决定探索它的cosmos DB活动。

Azure Cosmos DB是Azure云中一个完全管理的NoSQL数据库服务,它是全球分布的,适合现代应用开发。它是一种更快的、容易扩展的、高度可用的和安全的数据库服务。

使用Azure存储探索器执行各种Cosmos DB活动

我将在本节中向你展示使用存储资源管理器的各种cosmos DB活动。让我从连接到Azure账户开始,看看cosmos DB账户是否已经在你的Azure账户上创建。

使用Azure存储探索器连接到Azure账户

在你的桌面上启动Azure存储资源管理器。点击 "视图"标签,显示选项列表。选择账户管理来选择你的Azure账户。

Connect to Azure account using storage explorer

一旦你在上述屏幕上点击账户管理 ,就会出现以下屏幕。我已经从下图中选择了我所需要的订阅,点击它们各自的复选框。现在,点击显示在Azure账户复选框下面的 "打开资源管理器"标签。

Connect to Azure account using storage explorer

你可以看到在下面的资源管理器中显示了该订阅。展开Cosmos DB Accounts选项,显示未连接的订阅。我们在这个订阅下没有任何cosmos DB账户,所以它在这个选项下没有显示任何细节。使用Azure存储资源管理器对cosmos DB账户的支持将在未来的版本中被废弃,这就是为什么你可以看到除了cosmos DB账户选项外,还显示废弃的原因。

Connect to Azure account using storage explorer

我已经向你展示了如何连接到Azure账户,在本节中看到Azure存储资源管理器中连接的Cosmos DB账户。接下来,让我们在Azure门户上创建一个cosmos DB账户,并将其连接到存储资源管理器以执行各种活动。

创建一个Azure Cosmos DB账户

登录到Azure门户。在搜索栏中输入Azure Cosmos DB以显示这项服务。一旦你点击cosmos DB选项,将显示以下页面。所有cosmos DB账户都会显示在这个页面上。由于我们还没有配置cosmos DB,所以在下面的图片中没有显示任何细节。让我们继续前进并首先创建一个cosmos DB账户。

点击Azure Cosmos DB标题下的 +创建选项,或者点击下图中间的创建Azure Cosmos DB账户标签。

Azure cosmos DB page

下一个屏幕将根据我们的工作量来选择API。我从下图中选择了推荐的API核心(SQL),并点击了这个选项的创建按钮。

Choose desired API for cosmos db account

下面将出现名为 "创建Azure Cosmos DB账户-核心(SQL)"的屏幕,以填写所有需要的细节来创建一个Cosmos DB账户。如果你选择了与Core SQL不同的API,那么你将得到一个类似的表格,用于创建Cosmos DB账户的API。

由于我必须在存储资源管理器中进行演示,所以我保持所有的默认设置。

Create Azure cosmos DB account

一旦你在上图中显示的所有标签上输入了所有细节,然后点击审查+创建按钮,开始验证过程。你可以在下面的图片中看到验证是成功的。现在点击 "创建"按钮来继续。

validation

一旦你点击上图中的创建按钮,Azure cosmos DB账户的部署将开始处理。一旦部署完成,你会得到下面的屏幕。单击 "转到资源"选项卡,跳到cosmos DB账户。

cosmos db account created

让我们继续前进,并在下一节中使用Azure存储资源管理器连接到这个cosmos DB帐户。

使用Azure存储探索器连接到Azure Cosmos DB账户

有2种方法可以使用存储探索器连接到Azure Cosmos DB账户。一种是使用Azure账户,我们在第一节中已经通过该账户连接并扩展了Cosmos DB账户,另一种方法是直接连接到Cosmos DB账户,而不连接到Azure账户。让我在下面的图片中向你展示第一个选项。下面的屏幕是上面显示的第三张图片的复制品,我们已经连接到Azure账户,但没有cosmos DB账户。现在我们将点击下图中突出显示的刷新所有链接。一旦你刷新它,新创建的cosmos DB账户将开始出现在下图的其部分。

Connect to Azure account using storage explorer

第二个选择是直接连接到Azure Cosmos DB账户,而不需要连接到整个Azure账户。你需要新创建的Azure Cosmos DB帐户或任何你想连接到存储资源管理器的现有cosmos DB帐户的首要连接字符串。你需要访问cosmos DB账户设置下的密钥选项卡,以通过Azure门户获得主连接字符串。

下面的图片显示了钥匙选项卡的细节,以显示所有的连接字符串。点击右侧窗格中的暗红色矩形中的复制图标。

Get the primary connection string of cosmos db account

现在,回到Azure存储资源管理器,删除所有连接的Azure账户,如下图所示,我们可以看到没有Azure账户被连接。现在,单击 "打开资源管理器"以获得资源管理器视图。

Remove all Azure accounts from storage explorer

在这里,你可以看到Cosmos DB Accounts选项,如下图所示。右键单击该选项并单击 "连接到Cosmos DB... "以获得窗口,在该窗口中我们将为我们新创建的cosmos DB账户输入主连接字符串,以使用存储资源管理器建立连接。

Connect to cosmos db account using Azure storage explorer

下面的屏幕将出现,用于输入连接字符串。主要连接字符串将被输入到连接字符串输入框中。

Enter connection strinigs

在连接字符串框中输入上面步骤中复制的连接字符串,一旦你输入复制的连接字符串,账户标签将自动被识别和显示。你可以在下面的图片中看到,我没有输入账户标签,它已经在输入连接字符串后被填满。现在,点击下图中的 "下一步"按钮。

Enter connection strings of cosmos db account

将会出现一个摘要屏幕来验证连接的细节,如果一切看起来都很好,那么点击下图中底部的连接按钮。

Verify connection string while connecting  to cosmos db account

现在,我们可以在Azure存储资源管理器中看到我们新创建的cosmos DB账户cosmosdb19oct2021。如果不可见,请点击下图中的Refresh All链接。

Connect to cosmos db account using Azure storage explorer

在上图中,我们已经成功地使用Azure存储资源管理器连接到Azure Cosmos DB账户。现在,我将向你展示各种数据库级别的活动,我们可以使用存储资源管理器来执行cosmos DB帐户。

使用存储资源管理器创建一个Cosmos数据库

我们已经创建了一个cosmos DB账户并将其连接到存储探索器。现在,让我们探索一下我们可以使用Azure存储资源管理器在这个cosmos DB账户上执行的所有选项。右键单击已连接的数据库账户,以获得我们可以在cosmos DB账户级别执行的活动列表,这些活动的列表可以在下面的图片中看到。

List of options which we can perform at cosmos db account level

让我告诉你如何在这个cosmos DB账户中创建一个数据库。点击上图中的创建数据库选项,你会得到下面的文本框来输入数据库的名称。

Create New Database

输入数据库的名称并按回车键来创建它。你可以看到数据库mdscosmosDB已经在cosmos DB账户cosmosdb19oct2021下被创建。

New database

在本节中,我们已经在cosmos DB账户中创建了一个数据库。现在,我们将在下一节中执行数据库级别的活动。

使用Azure存储探索器在Azure Cosmos数据库中创建集合

我假设你已经有一个cosmos DB账户和一个数据库。你已经使用存储资源管理器连接到了cosmos DB账户,如下图所示。现在,我们将探索在cosmos DB账户中创建的数据库可以执行的所有活动。

展开连接的cosmos DB账户名称,右键单击显示在cosmos DB账户树中的数据库名称。你可以看到我们可以使用存储探索器对这个数据库进行的活动列表。

List of activities which can be performed at database level

让我告诉你如何在这个数据库中创建一个集合。点击上图中的创建集合...选项。你将在下面的窗口中输入集合ID和定义集合的存储容量。

Create new collection

输入所需的细节以继续创建集合。我已经输入了如下图所示的细节,并点击了OK按钮。

Create new collection

在下图中,你可以看到数据库中的集合被创建。在集合树下显示了一个对象列表,如文档、存储过程、触发器、用户定义的函数。

New collection

你可以继续测试其他的活动,我们可以在数据库层面上做。如果你想删除这个数据库,那么你可以从右键单击数据库名称后的列表中选择这个选项。确保你有一个备份,以防将来需要这些数据。

使用Azure存储资源管理器向cosmos DB集合添加一个新文件

现在,你可以继续向上述创建的集合添加一个文档。在新创建的集合下,点击下图左侧窗格中的文档选项。你将在右侧窗格中得到文档的详细信息探索器。点击图片顶部的 "新文档 "选项。

Click at New document option

下面的屏幕上会出现JSON格式的模板来创建一个文档。在这里你可以输入ID号和其他字段以及你想添加到这个文档的细节,然后点击保存按钮来保存这个文档。

Open New document window

我已经用下面的JSON字段细节创建了一个文档,并点击保存按钮来存储它。如果你点击保存按钮,有几个系统生成的字段将被自动添加到下面的JSON中。

Create the document using JSON

请看下面的图片,这里我只添加了Tags字段,但其余字段是在点击保存按钮后添加的。

Save the newly created document

同样地,你可以通过点击新建文档选项来创建多个文档,一旦你保存它们,它将看起来像下面的图片。

Create a New document

如果你想删除任何文档,你可以从ID栏中选择相应的文档ID,然后点击功能区栏中的删除按钮。

Delete a document

使用Azure存储探索器执行其他宇宙DB活动

我们还可以执行其他活动,比如我们可以通过右键单击该选项并选择创建存储过程来创建一个新的存储过程...。

Create a stored procedure

一旦你点击上述选项,它将要求你输入它的名字,一旦你按下回车键,下面的屏幕将在存储过程名称的右侧窗格中出现一个存储过程样本。

Create a stored procedure

总结

Azure存储资源管理器是一个非常有用的桌面应用程序,用于管理Azure存储和其他Azure云相关的服务,如cosmos DB和数据湖服务。今天我探讨了如何使用Azure存储探索器连接到Azure Cosmos DB帐户,并使用存储探索器对cosmos DB帐户及其对象执行各种活动,而无需进入Azure门户。在这篇文章中,你也学到了如何创建一个cosmos DB账户。