PowerShell を使用してワークスペースをデプロイする

  • [アーティクル]

この記事では、Powershell を使用して Azure Databricks ワークスペースを作成する方法について説明します。

ローカルで PowerShell を使用する場合は、Az PowerShell モジュールをインストールしたうえで、Connect-AzAccount コマンドレットを使用して自分の Azure アカウントに接続する必要があります。 Az PowerShell モジュールのインストールの詳細については、「Azure PowerShell のインストール」を参照してください。

ユーザーとして Azure アカウントに接続する場合は、「Azure Databricks ユーザー アカウントで PowerShell にログインする」を参照してください。 サービス プリンシパルとして Azure アカウントに接続するには、「Microsoft Entra ID (旧称 Azure Active Directory) サービス プリンシパルを使用した PowerShell ログイン」を参照してください。

Note

FedRAMP High などの米国政府のコンプライアンス認定資格を保持する Azure 商用クラウド内に Azure Databricks ワークスペースを作成する場合は、Microsoft または Azure Databricks アカウント チームに連絡して、このエクスペリエンスへのアクセスを取得してください。

Azure Databricks を初めて使用する場合は、Microsoft.Databricks リソースプロバイダーを登録する必要があります。

  Register-AzResourceProvider -ProviderNamespace Microsoft.Databricks

Azure Cloud Shell を使用する

Azure では、ブラウザーを介して使用できる対話型のシェル環境、Azure Cloud Shell がホストされています。 Cloud Shell で Bash または PowerShell を使用して、Azure サービスを操作できます。 ローカル環境に何もインストールしなくても、Cloud Shell にプレインストールされているコマンドを使用して、この記事のコードを実行できます。

Azure Cloud Shell を開始するには:

  • コード ブロックの右上隅にある [使ってみる] を選択します。 [使ってみる] を選択しても、コードは Cloud Shell に自動的にコピーされません。
  • https://shell.azure.com に移動するか、[Cloud Shell を起動する] ボタンを選択して、ブラウザーで Cloud Shell を開きます。
  • Azure portal の右上にあるメニュー バーの [Cloud Shell] ボタンを選択します。

Azure Cloud Shell でこの記事のコードを実行するには:

  • Cloud Shell を開始します。
  • [コピー] ボタンを選択して、コード ブロックをコードにコピーします。
  • Windows と Linux では Ctrl+Shift+V キーを選択し、macOS では Cmd+Shift+V キーを選択して、コードを Cloud Shell セッションに貼り付けます。
  • Enter キーを選択して、コードを実行します。

複数の Azure サブスクリプションをお持ちの場合は、リソースが課金の対象となる適切なサブスクリプションを選択してください。 Set-AzContext コマンドレットを使用して、特定のサブスクリプション ID を選択します。

Set-AzContext -SubscriptionId 00000000-0000-0000-0000-000000000000

リソース グループを作成する

New-AzResourceGroup コマンドレットを使用して、Azure リソース グループを作成します。 リソース グループとは、複数の Azure リソースをまとめてデプロイ、管理する際の論理コンテナーです。

次の例では、myResourceGroup という名前のリソース グループを米国西部 2 リージョンに作成します。

New-AzResourceGroup -Name myresourcegroup -Location westus2

Azure Databricks ワークスペースを作成する

このセクションでは、PowerShell を使用して Azure Databricks ワークスペースを作成します。

New-AzDatabricksWorkspace -Name mydatabricksws -ResourceGroupName myresourcegroup -Location westus2 -ManagedResourceGroupName databricks-group -Sku standard

次の値を指定します。

プロパティ 説明
Name Databricks ワークスペースの名前を指定します
ResourceGroupName 既存のリソース グループ名を指定します
場所 [米国西部 2] を選択します。 その他の利用可能なリージョンについては、リージョン別の利用可能な製品に関するページをご覧ください
ManagedResourceGroupName 新しい管理対象リソース グループを作成するか、既存のグループを使用するかを指定します。
Sku Standard、Premium、Trial のいずれかを選択します。 これらのレベルの詳細については、Databricks の価格に関するページをご覧ください

ワークスペースの作成には数分かかります。 この処理が完了すると、ユーザー アカウントが管理者ユーザーとして自動的にワークスペースに追加されます。

注意

ワークスペースのデプロイが失敗した場合でも、ワークスペースはエラー状態で作成されます。 失敗したワークスペースを削除し、デプロイ エラーのない新しいワークスペースを作成します。 失敗したワークスペースを削除すると、管理対象リソース グループと、正常にデプロイされたリソースもすべて削除されます。

Databricks ワークスペースのプロビジョニングの状態を確認する

Databricks ワークスペースが正常にプロビジョニングされたかどうかを確認するには、Get-AzDatabricksWorkspace コマンドレットを使用できます。

Get-AzDatabricksWorkspace -Name mydatabricksws -ResourceGroupName myresourcegroup |
  Select-Object -Property Name, SkuName, Location, ProvisioningState

Name            SkuName   Location  ProvisioningState
----            -------   --------  -----------------
mydatabricksws  standard  westus2   Succeeded