クイックスタート: Azure CLI を使用して Synapse SQL プールを作成する

[アーティクル]
03/10/2023

Azure CLI を使用して、Azure Synapse Analytics で Synapse SQL プール (データウェアハウス) を作成します。

前提条件

Azure Cloud Shell で Bash 環境を使用します。詳細については、「Azure Cloud Shell の Bash のクイックスタート」を参照してください。
CLI リファレンスコマンドをローカルで実行する場合、Azure CLI をインストールします。 Windows または macOS で実行している場合は、Docker コンテナーで Azure CLI を実行することを検討してください。詳細については、「Docker コンテナーで Azure CLI を実行する方法」を参照してください。
- ローカルインストールを使用する場合は、az login コマンドを使用して Azure CLI にサインインします。認証プロセスを完了するには、ターミナルに表示される手順に従います。その他のサインインオプションについては、Azure CLI でのサインインに関するページを参照してください。
- 初回使用時にインストールを求められたら、Azure CLI 拡張機能をインストールします。拡張機能の詳細については、Azure CLI で拡張機能を使用する方法に関するページを参照してください。
- az version を実行し、インストールされているバージョンおよび依存ライブラリを検索します。最新バージョンにアップグレードするには、az upgrade を実行します。

作業の開始

次のコマンドを使用して Azure にサインオンし、リソースグループを設定します。

ローカルインストールを使用している場合は、az login コマンドを実行して Azure にサインインします。
```
az login
```
必要に応じて、az account set コマンドを使用して、お使いのサブスクリプションを選択します。
```
az account set --subscription 00000000-0000-0000-0000-000000000000
```
az group create コマンドを実行してリソースグループを作成します。
```
az group create --name myResourceGroup --location WestEurope
```
az sql server create コマンドを使用して、論理 SQL サーバーを作成します。
```
az sql server create --resource-group myResourceGroup --name mysqlserver \
   --admin-user ServerAdmin --admin-password ChangeYourAdminPassword1
```
サーバーには、ひとまとめにして管理される一連のデータベースが含まれています。

サーバーレベルのファイアウォール規則の構成

サーバーレベルのファイアウォール規則を作成します。サーバーレベルのファイアウォール規則を作成すると、SQL Server Management Studio や SQLCMD ユーティリティのような外部アプリケーションから、SQL プールサービスのファイアウォールを介して SQL プールに接続できます。

az sql server firewall-rule create コマンドを実行して、ファイアウォール規則を作成します。

az sql server firewall-rule create --resource-group myResourceGroup --name AllowSome \
   --server mysqlserver --start-ip-address 0.0.0.0 --end-ip-address 0.0.0.0

この例では、他の Azure リソースに対してのみファイアウォールを開放しています。外部から接続できるようにするには、実際の環境に合わせて IP アドレスを変更してください。すべての IP アドレスを開放するには、開始 IP アドレスとして 0.0.0.0 を、終了アドレスとして 255.255.255.255 を使用します。

注意

SQL エンドポイントの通信は、ポート 1433 で行われます。企業ネットワーク内から接続しようとしても、ポート 1433 での送信トラフィックがネットワークのファイアウォールで禁止されている場合があります。その場合、会社の IT 部門によってポート 1433 が開放されない限り、サーバーに接続することはできません。

SQL プールを作成および管理する

SQL プールを作成します。この例では、サービス目標として DW100c を使用しています。これは、SQL プール用の低コストの開始点です。

注意

以前に作成したワークスペースが必要です。詳細については、「クイックスタート: Azure CLI を使用して Azure Synapse ワークスペースを作成する」を参照してください。

SQL プールを作成するには、az synapse sql pool create コマンドを使用します。

az synapse sql pool create --resource-group myResourceGroup --name mySampleDataWarehouse \
   --performance-level "DW1000c" --workspace-name testsynapseworkspace

パラメーターオプションの詳細については、「az synapse sql pool」を参照してください。

az synapse sql pool list コマンドを使用すると、対象の SQL プールを確認できます。

az synapse sql pool list --resource-group myResourceGroup --workspace-name testsynapseworkspace

既存のプールを更新するには、az synapse sql pool update コマンドを使用します。

az synapse sql pool update --resource-group myResourceGroup --name mySampleDataWarehouse \
   --workspace-name testsynapseworkspace

プールを一時停止するには、az synapse sql pool pause コマンドを使用します。

az synapse sql pool pause --resource-group myResourceGroup --name mySampleDataWarehouse \
   --workspace-name testsynapseworkspace

一時停止しているプールを開始するには、az synapse sql pool resume コマンドを使用します。

az synapse sql pool resume --resource-group myResourceGroup --name mySampleDataWarehouse \
   --workspace-name testsynapseworkspace

既存の SQL プールを削除するには、az synapse sql pool delete コマンドを使用します。

az synapse sql pool delete --resource-group myResourceGroup --name mySampleDataWarehouse \
   --workspace-name testsynapseworkspace

リソースをクリーンアップする

このコレクションの他のクイックスタートチュートリアルは、このクイックスタートに基づいています。

ヒント

引き続きクイックスタートチュートリアルの作業を行う場合は、このクイックスタートで作成したリソースをクリーンアップしないでください。作業する予定がない場合は、az group delete コマンドを使用して、このクイックスタートで作成されたすべてのリソースを削除してください。

az group delete --ResourceGroupName MyResourceGroup

次のステップ

ここでは SQL プールを作成し、ファイアウォール規則を作成し、SQL プールに接続しました。理解をさらに深めるために、SQL プールへのデータの読み込みに関する記事に進んでください。

次の方法で共有