PowerShell을 사용하여 Azure Data Explorer 클러스터 및 데이터베이스 만들기Create an Azure Data Explorer cluster and database by using PowerShell

Azure Data Explorer는 애플리케이션, 웹 사이트, IoT 디바이스 등으로부터 대량의 데이터 스트리밍에 대한 실시간 분석을 제공하는 빠른 속도의 완전 관리형 데이터 분석 서비스입니다.Azure Data Explorer is a fast, fully managed data analytics service for real-time analysis on large volumes of data streaming from applications, websites, IoT devices, and more. Azure Data Explorer를 사용하려면 먼저 클러스터를 만들고 이 클러스터에 데이터베이스를 하나 이상 만듭니다.To use Azure Data Explorer, you first create a cluster, and create one or more databases in that cluster. 그런 다음, 데이터베이스에 대해 쿼리를 실행할 수 있도록 데이터베이스에 데이터를 수집(로드)합니다.Then you ingest (load) data into a database so that you can run queries against it. 이 문서에서는 Powershell을 사용 하 여 클러스터 및 데이터베이스를 만듭니다.In this article, you create a cluster and a database by using Powershell. Az.Kusto와 함께 Azure Cloud Shell에서 또는 Windows, Linux에서 PowerShell cmdlet 및 스크립트를 실행하여 Azure Data Explorer 클러스터와 데이터베이스를 만들고 구성할 수 있습니다.You can run PowerShell cmdlets and scripts on Windows, Linux, or in Azure Cloud Shell with Az.Kusto to create and configure Azure Data Explorer clusters and databases.

필수 구성 요소Prerequisites

참고

이 문서는 새 Azure PowerShell Az 모듈을 사용하도록 업데이트되었습니다.This article has been updated to use the new Azure PowerShell Az module. AzureRM 모듈은 적어도 2020년 12월까지 버그 수정을 수신할 예정이므로 계속 사용하셔도 됩니다.You can still use the AzureRM module, which will continue to receive bug fixes until at least December 2020. 새 Az 모듈 및 AzureRM 호환성에 대한 자세한 내용은 새 Azure PowerShell Az 모듈 소개를 참조하세요.To learn more about the new Az module and AzureRM compatibility, see Introducing the new Azure PowerShell Az module. Az 모듈 설치 지침은 Azure PowerShell 설치를 참조하세요.For Az module installation instructions, see Install Azure PowerShell.

Azure 구독이 아직 없는 경우 시작하기 전에 체험 계정을 만듭니다.If you don't have an Azure subscription, create a free account before you begin.

Azure Cloud Shell 사용Use Azure Cloud Shell

Azure는 브라우저를 통해 사용할 수 있는 대화형 셸 환경인 Azure Cloud Shell을 호스트합니다.Azure hosts Azure Cloud Shell, an interactive shell environment that you can use through your browser. Cloud Shell에서 Bash 또는 PowerShell을 사용하여 Azure 서비스 작업을 수행할 수 있습니다.You can use either Bash or PowerShell with Cloud Shell to work with Azure services. 로컬 환경에 아무 것도 설치할 필요 없이 Azure Cloud Shell의 미리 설치된 명령을 사용하여 이 문서의 코드를 실행할 수 있습니다.You can use the Cloud Shell preinstalled commands to run the code in this article without having to install anything on your local environment.

Azure Cloud Shell을 시작하려면 다음을 수행합니다.To start Azure Cloud Shell:

옵션Option 예제/링크Example/Link
코드 블록의 오른쪽 위 모서리에서 사용을 선택합니다.Select Try It in the upper-right corner of a code block. 사용해보기를 선택하면 코드가 Cloud Shell에 자동으로 복사되지 않습니다.Selecting Try It doesn't automatically copy the code to Cloud Shell. Azure Cloud Shell에 대한 사용 예제
https://shell.azure.com으로 이동하거나 Cloud Shell 시작 버튼을 선택하여 브라우저에서 Cloud Shell을 엽니다.Go to https://shell.azure.com, or select the Launch Cloud Shell button to open Cloud Shell in your browser. 새 창에서 Cloud Shell 시작Launch Cloud Shell in a new window
Azure Portal의 오른쪽 위에 있는 메뉴 모음에서 Cloud Shell 단추를 선택합니다.Select the Cloud Shell button on the menu bar at the upper right in the Azure portal. Azure Portal의 Cloud Shell 단추

이 문서의 코드를 Azure Cloud Shell에서 실행하려면 다음을 수행합니다.To run the code in this article in Azure Cloud Shell:

  1. Cloud Shell을 시작합니다.Start Cloud Shell.

  2. 코드 블록의 복사 단추를 선택하여 코드를 복사합니다.Select the Copy button on a code block to copy the code.

  3. Windows 및 Linux에서 Ctrl+Shift+V를 선택하거나 macOS에서 Cmd+Shift+V를 선택하여 코드를 Cloud Shell 세션에 붙여넣습니다.Paste the code into the Cloud Shell session by selecting Ctrl+Shift+V on Windows and Linux or by selecting Cmd+Shift+V on macOS.

  4. Enter를 선택하여 코드를 실행합니다.Select Enter to run the code.

Azure CLI를 로컬로 설치 하 고 사용 하도록 선택 하는 경우이 문서에서는 Azure CLI 버전 2.0.4 이상을 이상이 필요 합니다.If you choose to install and use the Azure CLI locally, this article requires the Azure CLI version 2.0.4 or later. az --version을 실행하여 버전을 확인합니다.Run az --version to check your version. 설치 또는 업그레이드가 필요한 경우, Azure CLI 설치를 참조하세요.If you need to install or upgrade, see Install the Azure CLI.

매개 변수 구성Configure parameters

Azure Cloud Shell에서 명령을 실행하는 경우에는 다음 단계가 필요하지 않습니다.The following steps are not required if you're running commands in Azure Cloud Shell. 로컬에서 CLI를 실행하는 경우 1과 2단계에 따라 Azure에 로그인하고 현재 구독을 설정합니다.If you're running the CLI locally, follow steps 1 & 2 to sign in to Azure and to set your current subscription:

  1. 다음 명령을 실행하여 Azure에 로그인합니다.Run the following command to sign in to Azure:

    Connect-AzAccount
    
  2. 클러스터를 만들 구독을 설정합니다.Set the subscription where you want your cluster to be created:

     Set-AzContext -SubscriptionId "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
    
  3. Azure CLI를 로컬이나 Azure Cloud Shell에서 실행하는 경우 디바이스에 Az.Kusto 모듈을 설치해야 합니다.When running Azure CLI locally or in the Azure Cloud Shell, you need to install the Az.Kusto module on your device:

     Install-Module -Name Az.Kusto
    

Azure Data Explorer 클러스터 만들기Create the Azure Data Explorer cluster

  1. 다음 명령을 사용하여 클러스터를 만듭니다.Create your cluster by using the following command:

     New-AzKustoCluster -ResourceGroupName testrg -Name mykustocluster -Location 'Central US' -Sku D13_v2 -Capacity 10
    
    설정Setting 제안 값Suggested value 필드 설명Field description
    NameName mykustoclustermykustocluster 원하는 클러스터 이름입니다.The desired name of your cluster.
    SKUSku D13_v2D13_v2 클러스터에 사용될 SKU입니다.The SKU that will be used for your cluster.
    ResourceGroupNameResourceGroupName testrgtestrg 클러스터가 만들어질 리소스 그룹 이름입니다.The resource group name where the cluster will be created.

    사용 가능한 선택적 매개 변수(예: 클러스터 용량)가 추가로 있습니다.There are additional optional parameters that you can use, such as the capacity of the cluster.

  2. 다음 명령을 실행하여 클러스터가 성공적으로 만들어졌는지 확인합니다.Run the following command to check whether your cluster was successfully created:

    Get-AzKustoCluster -Name mykustocluster -ResourceGroupName testrg
    

결과에 값이 SucceededprovisioningState가 있으면 클러스터가 성공적으로 만들어진 것입니다.If the result contains provisioningState with the Succeeded value, then the cluster was successfully created.

Azure Data Explorer 클러스터에 데이터베이스 만들기Create the database in the Azure Data Explorer cluster

  1. 다음 명령을 사용하여 데이터베이스를 만듭니다.Create your database by using the following command:

    New-AzKustoDatabase -ResourceGroupName testrg -ClusterName mykustocluster -Name mykustodatabase -SoftDeletePeriod 3650:00:00:00 -HotCachePeriod 3650:00:00:00
    
    설정Setting 제안 값Suggested value 필드 설명Field description
    ClusterNameClusterName mykustoclustermykustocluster 데이터베이스가 만들어지는 클러스터의 이름입니다.The name of your cluster where the database will be created.
    NameName mykustodatabasemykustodatabase 데이터베이스의 이름입니다.The name of your database.
    ResourceGroupNameResourceGroupName testrgtestrg 클러스터가 만들어질 리소스 그룹 이름입니다.The resource group name where the cluster will be created.
    SoftDeletePeriodSoftDeletePeriod 3650:00:00:003650:00:00:00 데이터를 쿼리할 수 있도록 유지되는 시간입니다.The amount of time that data will be kept available to query.
    HotCachePeriodHotCachePeriod 3650:00:00:003650:00:00:00 데이터가 캐시에 유지되는 시간입니다.The amount of time that data will be kept in cache.
  2. 다음 명령을 실행하여 직접 만든 데이터베이스를 살펴봅니다.Run the following command to see the database that you created:

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

이제 클러스터와 데이터베이스가 있습니다.You now have a cluster and a database.

리소스 정리Clean up resources

  • 다른 문서를 따르려면 만든 리소스를 유지 합니다.If you plan to follow our other articles, keep the resources you created.

  • 리소스를 정리하려면 클러스터를 삭제합니다.To clean up resources, delete the cluster. 클러스터를 삭제하면 해당 클러스터에 있는 모든 데이터베이스도 함께 삭제됩니다.When you delete a cluster, it also deletes all the databases in it. 다음 명령을 사용하여 클러스터를 삭제합니다.Use the following command to delete your cluster:

    Remove-AzKustoCluster -ResourceGroupName testrg -Name mykustocluster
    

다음 단계Next steps