クイック スタート:Visual Studio で .NET と C# を使用して Azure SQL データベースに接続してクエリを実行するQuickstart: Use .NET and C# in Visual Studio to connect to and query an Azure SQL database

このクイック スタートでは、Visual Studio で .NET Framework と C# コードを使用し、Azure SQL データベースに対して Transact-SQL ステートメントを使用してクエリを実行する方法について説明します。This quickstart shows how to use the .NET framework and C# code in Visual Studio to query an Azure SQL database with Transact-SQL statements.

前提条件Prerequisites

このクイック スタートを完了するには、次のものが必要です。To complete this quickstart, you need:

SQL サーバーの接続情報を取得するGet SQL server connection information

Azure SQL データベースに接続するために必要な接続情報を取得します。Get the connection information you need to connect to the Azure SQL database. 後の手順で、完全修飾サーバー名またはホスト名、データベース名、およびログイン情報が必要になります。You'll need the fully qualified server name or host name, database name, and login information for the upcoming procedures.

  1. Azure Portal にサインインします。Sign in to the Azure portal.

  2. [SQL データベース] または [SQL マネージド インスタンス] ページに移動します。Navigate to the SQL databases or SQL managed instances page.

  3. [概要] ページで、単一データベースの場合は [サーバー名] の横の完全修飾サーバー名を確認し、マネージド インスタンスの場合は [ホスト] の横の完全修飾サーバー名を確認します。On the Overview page, review the fully qualified server name next to Server name for a single database or the fully qualified server name next to Host for a managed instance. サーバー名またはホスト名をコピーするには、名前をポイントして [コピー] アイコンを選択します。To copy the server name or host name, hover over it and select the Copy icon.

SQL データベースに対してクエリを実行するコードを作成するCreate code to query the SQL database

  1. Visual Studio で、 [ファイル] > [新規] > [プロジェクト] の順に選択します。In Visual Studio, select File > New > Project.

  2. [新しいプロジェクト] ダイアログで、 [Visual C#][コンソール アプリ (.NET Framework)] の順に選択します。In the New Project dialog, select Visual C#, and then select Console App (.NET Framework).

  3. プロジェクトの名前に「sqltest」と入力して、 [OK] を選択します。Enter sqltest for the project name, and then select OK. 新しいプロジェクトが作成されます。The new project is created.

  4. [プロジェクト] > [NuGet パッケージの管理] の順に選択します。Select Project > Manage NuGet Packages.

  5. [NuGet パッケージ マネージャー][参照] タブを選択し、System.Data.SqlClient を検索して選択します。In NuGet Package Manager, select the Browse tab, then search for and select System.Data.SqlClient.

  6. [System.Data.SqlClient] ページで [インストール] を選択します。On the System.Data.SqlClient page, select Install.

    • プロンプトが表示されたら、 [OK] を選択してインストールを続行します。If prompted, select OK to continue with the installation.
    • [ライセンスへの同意] ウィンドウが表示された場合は [同意する] を選択します。If a License Acceptance window appears, select I Accept.
  7. インストールが完了すると、 [NuGet パッケージ マネージャー] を閉じることができます。When the install completes, you can close NuGet Package Manager.

  8. コード エディターで Program.cs の内容を次のコードに置き換えます。In the code editor, replace the Program.cs contents with the following code. <server><username><password><database> は実際の値に置き換えます。Replace your values for <server>, <username>, <password>, and <database>.

    重要

    この例のコードでは、サンプル データ AdventureWorksLT を使用します。これは、データベースの作成時にソースとして選択できます。The code in this example uses the sample AdventureWorksLT data, which you can choose as source when creating your database. データベースに別のデータがある場合は、SELECT クエリで独自のデータベースからのテーブルを使用します。If your database has different data, use tables from your own database in the SELECT query.

    using System;
    using System.Data.SqlClient;
    using System.Text;
    
    namespace sqltest
    {
        class Program
        {
            static void Main(string[] args)
            {
                try 
                { 
                    SqlConnectionStringBuilder builder = new SqlConnectionStringBuilder();
                    builder.DataSource = "<server>.database.windows.net"; 
                    builder.UserID = "<username>";            
                    builder.Password = "<password>";     
                    builder.InitialCatalog = "<database>";
    
                    using (SqlConnection connection = new SqlConnection(builder.ConnectionString))
                    {
                        Console.WriteLine("\nQuery data example:");
                        Console.WriteLine("=========================================\n");
    
                        connection.Open();       
                        StringBuilder sb = new StringBuilder();
                        sb.Append("SELECT TOP 20 pc.Name as CategoryName, p.name as ProductName ");
                        sb.Append("FROM [SalesLT].[ProductCategory] pc ");
                        sb.Append("JOIN [SalesLT].[Product] p ");
                        sb.Append("ON pc.productcategoryid = p.productcategoryid;");
                        String sql = sb.ToString();
    
                        using (SqlCommand command = new SqlCommand(sql, connection))
                        {
                            using (SqlDataReader reader = command.ExecuteReader())
                            {
                                while (reader.Read())
                                {
                                    Console.WriteLine("{0} {1}", reader.GetString(0), reader.GetString(1));
                                }
                            }
                        }                    
                    }
                }
                catch (SqlException e)
                {
                    Console.WriteLine(e.ToString());
                }
                Console.ReadLine();
            }
        }
    }
    

コードの実行Run the code

  1. アプリを実行するには、 [デバッグ] > [デバッグの開始] の順に選択するか、ツールバーの [開始] を選択するか、F5 キーを押します。To run the app, select Debug > Start Debugging, or select Start on the toolbar, or press F5.
  2. データベースの上位 20 のカテゴリ/製品行が返されていることを確認し、アプリ ウィンドウを閉じます。Verify that the top 20 Category/Product rows from your database are returned, and then close the app window.

次の手順Next steps