使用 PowerShell 创建 Azure 数据资源管理器群集和数据库

Azure 数据资源管理器是一项快速、完全托管的数据分析服务,用于实时分析从应用程序、网站和 IoT 设备等资源流式传输的海量数据。 若要使用 Azure 数据资源管理器,请先创建群集,再在该群集中创建一个或多个数据库。 然后将数据引入(加载)到数据库,以便对其运行查询。 在本文中,将使用 Powershell 创建群集和数据库。 可以在 Windows、Linux 或 Azure CLI 中使用 Az.Kusto 运行 PowerShell cmdlet 和脚本,以创建和配置 Azure 数据资源管理器群集和数据库。

先决条件

备注

本文进行了更新,以便使用新的 Azure PowerShell Az 模块。 你仍然可以使用 AzureRM 模块,至少在 2020 年 12 月之前,它将继续接收 bug 修补程序。 若要详细了解新的 Az 模块和 AzureRM 兼容性,请参阅新 Azure Powershell Az 模块简介。 有关 Az 模块安装说明,请参阅安装 Azure PowerShell

如果没有 Azure 订阅,可在开始前创建一个试用帐户

如果选择在本地安装并使用 Azure CLI,本文需要 Azure CLI 2.0.4 或更高版本。 请运行 az --version 检查版本。 如需进行安装或升级,请参阅安装 Azure CLI

配置参数

如果在 Azure PowerShell 中运行命令,则不需要执行以下步骤。 如果在本地运行 CLI,请按步骤 1 和 2 登录到 Azure 并设置当前订阅:

  1. 运行以下命令来登录到 Azure:

    Connect-AzAccount -EnvironmentName AzureChinaCloud
    
  2. 设置要在其中创建群集的订阅:

     Set-AzContext -SubscriptionId "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
    
  3. 在本地或 Azure PowerShell 中运行 Azure CLI 时,需要在设备上安装 Az.Kusto 模块:

     Install-Module -Name Az.Kusto
    

创建 Azure 数据资源管理器群集

  1. 请使用以下命令创建群集:

     New-AzKustoCluster -ResourceGroupName testrg -Name mykustocluster -Location 'China East 2' -Sku D13_v2 -Capacity 10
    
    设置 建议的值 字段说明
    名称 mykustocluster 所需的群集名称。
    SKU D13_v2 将用于群集的 SKU。
    ResourceGroupName testrg 将在其中创建群集的资源组名称。

    可以使用其他可选参数,例如群集的容量。

  2. 运行以下命令,检查群集是否已成功创建:

    Get-AzKustoCluster -Name mykustocluster -ResourceGroupName testrg
    

如果结果包含带 Succeeded 值的 provisioningState,则表示已成功创建群集。

在 Azure 数据资源管理器群集中创建数据库

  1. 请使用以下命令创建数据库:

    New-AzKustoDatabase -ResourceGroupName testrg -ClusterName mykustocluster -Name mykustodatabase -SoftDeletePeriod 3650:00:00:00 -HotCachePeriod 3650:00:00:00
    
    设置 建议的值 字段说明
    ClusterName mykustocluster 将在其中创建数据库的群集的名称。
    名称 mykustodatabase 数据库名称。
    ResourceGroupName testrg 将在其中创建群集的资源组名称。
    SoftDeletePeriod 3650:00:00:00 供查询使用的数据的保留时间。
    HotCachePeriod 3650:00:00:00 数据将在缓存中保留的时间。
  2. 若要查看已创建的数据库,请运行以下命令:

    Get-AzKustoDatabase -ClusterName mykustocluster -ResourceGroupName testrg -Name mykustodatabase
    

现在,你有了一个群集和一个数据库。

清理资源

  • 如果计划学习我们的其他文章,请保留已创建的资源。

  • 若要清理资源,请删除群集。 删除群集时,也会删除其中的所有数据库。 使用以下命令删除群集:

    Remove-AzKustoCluster -ResourceGroupName testrg -Name mykustocluster
    

后续步骤