この記事では、Powershell を使用して Azure Databricks ワークスペースを作成する方法について説明します。
ローカルで PowerShell を使用する場合は、Az PowerShell モジュールをインストールしたうえで、Connect-AzAccount コマンドレットを使用して自分の Azure アカウントに接続する必要があります。 Az PowerShell モジュールのインストールの詳細については、「Azure PowerShell のインストール」を参照してください。
ユーザー アカウントまたはサービス プリンシパルを使用して Azure アカウントに接続するには、「 Azure PowerShell を使用した認証」を参照してください。
注
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
次の値を指定します。
| プロパティ | 説明 |
|---|---|
| 名前 | Databricks ワークスペースの名前を指定します |
| リソースグループ名 | 既存のリソース グループ名を指定します |
| 場所 | [米国西部 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