クイック スタート: Azure portal のクエリ エディターを使用して Azure SQL Database のクエリを実行する

  • [アーティクル]

適用対象:Azure SQL Database

Azure SQL データベースのクエリ エディター (プレビュー) は、Azure portal で Azure SQL データベースに対して SQL クエリを実行するためのツールです。 このクイックスタートでは、Azure portal で Azure SQL データベースに接続し、クエリ エディターを使って Transact-SQL (T-SQL) のクエリを実行します。

前提条件

認証

データベースに接続し、クエリエディタを使用するためには、適切な権限を持つアカウントが必要です。 SQL 認証または Microsoft Entra ID) 認証を使用できます (推奨)。 Azure SQL データベースにおけるログインの作成と管理の詳細については、「データベース アクセスを承認する」に関するページを参照してください。

パブリック ネットワーク アクセス、TLS バージョン設定、接続ポリシーの詳細については、「Azure SQL の接続設定」に関するページを参照してください。

ファイアウォール規則

クエリ エディターへのパブリック接続の場合、お使いのデータベースにアクセスできるようにするには、サーバーの許可されたファイアウォール規則に、アウトバウンド IP アドレスを追加する必要があります。

このエラーを受信した場合は、次の手順に従って解決します。

Cannot open server 'server-name' requested by the login. Client with IP address 'xx.xx.xx.xx' is not allowed to access the server. To enable access, use the Azure Management Portal or run sp_set_firewall_rule on the master database to create a firewall rule for this IP address or address range. It may take up to five minutes for this change to take effect.

先に示したクイック操作に従ってください。または、詳細については、「サーバーの許可されたファイアウォール規則に送信元IPアドレスを追加する」をご覧ください。

  1. SQL データベースの [概要] ページに戻ります。
  2. [サーバー名] の横にある Azure SQL 論理サーバーのリンクを 選択します。
  3. リソース メニューの [セキュリティ] で [ネットワーク] を選択します。
  4. [パブリック ネットワーク アクセス] で、[選択したネットワーク] オプションが選択されていることを確認します。
    • これがテスト環境または一時的な環境の場合は、オプションを [選択されたネットワーク] に設定します。
    • そうでない場合は、ネットワーク アクセスの概要で説明されているように、(Azure Private Link を使用して) プライベート エンドポイントを介してなど、このクイック スタートで説明されている方法以外の方法でアクセス権を付与する必要があります。
  5. ファイアウォール規則で、[クライアント IPv4 アドレスの追加] を選択します。
    • 必要に応じて、IPv4 アドレスを識別し、[開始] フィールドと [終了] フィールドに入力します。
  6. [保存] を選択します。

トラブルシューティングについては、「接続エラーのトラブルシューティング」を参照してください。

クエリ エディターに接続する

クエリ エディター内でデータベースに接続します。

  1. Azure portal で、SQL Database 移動します。 たとえば、Azure SQL ダッシュボードにアクセスします。

  2. SQL Database の[概要] ページで、リソース メニューから [クエリ エディター (プレビュー)] を選択します。

    クエリ エディターの選択を示すスクリーンショット。

  3. サインイン画面で、資格情報を入力してデータベースに接続します。

    • SQL または Microsoft Entra 認証 で接続できます。

      • SQL 認証を使用して接続するには、[SQL サーバー認証] で、データベースにアクセスできるユーザーの [ログイン] と [パスワード] を入力し、[OK] を選択します。 サーバー管理者のログインとパスワードは常に使用できます。

      • Microsoft Entra ID を使用して接続するには、Microsoft Entra サーバー管理者の場合は、[<user@domain>で続行] を選択します。 サインインが成功しなかった場合、ページを更新してみてください。

        Microsoft Entra 認証によるサインインを示す Azure portal のスクリーンショット。

他のツールとの接続

次のような他のツールを使用して、Azure SQL データベースに接続することもできます。

データベースのクエリを実行する

任意のデータベースで、クエリ エディターで次のクエリを実行して、時刻 (UTC)、データベース名、および認証済みログイン名を返します。

SELECT SYSDATETIMEOFFSET(), DB_NAME(), ORIGINAL_LOGIN();

AdventureWorksLT サンプル データベースのクエリ

このクイックスタートでは、Azure SQL データベースの AdventureWorksLT サンプル データベースを使用します。 まだお持ちでない場合は、Azure SQL Database のサンプル データを使用してデータベースを作成できます。 プランを使用して Azure SQL データベースを無料 (プレビュー) で試すオプションを探します。

[クエリ エディター (プレビュー)] ページで、AdventureWorksLT サンプル データベースに対して次のクエリ例を実行します。

ヒント

新規の Azure SQL データベース？ Azure SQL Fundamentals という詳細な無料トレーニング コンテンツ を使用して、迅速に作業を開始するか、「Azure SQL の用語集」を確認します。

Azure SQL データベースの T-SQL の詳細については、「SQL Server と Azure SQL データベースの T-SQL の相違点」に関するページを参照してください。

SELECT クエリを実行する

  1. データベース内の上位 20 の製品のクエリを実行するには、次の SELECT クエリをクエリ エディターに貼り付けます。

     SELECT TOP 20 pc.Name as CategoryName, p.name as ProductName
 FROM SalesLT.ProductCategory pc
 JOIN SalesLT.Product p
 ON pc.productcategoryid = p.productcategoryid;

  2. [実行] を選択し、[結果] ペインで出力を確認します。

    クエリ エディターに表示された SELECT クエリの結果を示すスクリーンショット。

  3. 必要に応じて、[クエリの保存] を選択してクエリを .sql ファイルとして保存するか、[データを .json としてエクスポート]、[データを .csvとしてエクスポート]、または [データを .xml としてエクスポート] を選択し、結果をいずれかのファイルにエクスポートします。

INSERT クエリを実行する

新しい製品を SalesLT.Product テーブルに追加するには、次の INSERT T-SQL ステートメントを実行します。

  1. クエリ エディターで、前述のクエリを次のクエリに置き換えます。

    INSERT INTO [SalesLT].[Product]
       ( [Name]
       , [ProductNumber]
       , [Color]
       , [ProductCategoryID]
       , [StandardCost]
       , [ListPrice]
       , [SellStartDate]
       )
VALUES
       ('myNewProduct'
       ,123456789
       ,'NewColor'
       ,1
       ,100
       ,100
       ,GETDATE() );

  2. [実行] を選択して新しい製品を追加します。 クエリを実行した後、[メッセージ] ペインに、[クエリが成功しました: 影響を受ける行: 1] が表示されます。

UPDATE クエリを実行する

次の UPDATE T-SQL ステートメントを実行して、新しい製品の価格を更新します。

  1. クエリ エディターで、前述のクエリを次のクエリに置き換えます。

    UPDATE [SalesLT].[Product]
SET [ListPrice] = 125
WHERE Name = 'myNewProduct';

  2. [実行] を選択して、Product テーブルの指定した行を更新します。 メッセージ ペインに、 [クエリが成功しました: 影響を受ける行: 1] と表示されます。

DELETE クエリを実行する

次の DELETE T-SQL ステートメントを実行して、新しい製品を削除します。

  1. クエリ エディターで、前述のクエリを次のクエリに置き換えます。

    DELETE FROM [SalesLT].[Product]
WHERE Name = 'myNewProduct';

  2. [実行] を選択して、Product テーブルの指定した行を削除します。 メッセージ ペインに、 [クエリが成功しました: 影響を受ける行: 1] と表示されます。

関連するコンテンツ