Démarrage rapide : Utiliser Java pour interroger une base de données Azure SQLQuickstart: Use Java to query an Azure SQL database

Dans ce guide de démarrage rapide, vous utilisez Java pour vous connecter à une base de données Azure SQL et vous utilisez des instructions T-SQL pour interroger les données.In this quickstart, you use Java to connect to an Azure SQL database and use T-SQL statements to query data.

Conditions préalables requisesPrerequisites


Important

Les scripts fournis dans cet article utilisent la base de données Adventure Works.The scripts in this article are written to use the Adventure Works database.

Notes

Vous pouvez éventuellement choisir d’utiliser une instance gérée d’Azure SQL.You can optionally choose to use an Azure SQL managed instance.

Pour créer et configurer, utilisez le portail Azure, PowerShell ou CLI, puis configurez sur site ou par le biais d’une connexion aux machines virtuelles.To create and configure, use the Azure Portal, PowerShell, or CLI, then setup on-site or VM connectivity.

Pour charger des données, consultez Restaurer avec BACPAC avec le fichier Adventure Works, ou consultez Restaurer la base de données Wide World Importers.To load data, see restore with BACPAC with the Adventure Works file, or see restore the Wide World Importers database.

Obtenir des informations de connexion SQL ServerGet SQL server connection information

Procurez-vous les informations de connexion dont vous avez besoin pour vous connecter à la base de données Azure SQL.Get the connection information you need to connect to the Azure SQL database. Vous aurez besoin du nom complet du serveur ou de l’hôte, du nom de la base de données et des informations de connexion pour les procédures suivantes.You'll need the fully qualified server name or host name, database name, and login information for the upcoming procedures.

  1. Connectez-vous au portail Azure.Sign in to the Azure portal.

  2. Sélectionnez Bases de données SQL ou ouvrez la page Instances managées SQL.Select SQL databases or open the SQL managed instances page.

  3. Dans la page Vue d’ensemble, vérifiez le nom complet du serveur à côté de Nom du serveur pour une base de données, ou le nom complet du serveur à côté de Hôte pour une instance managée.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. Pour copier le nom du serveur ou de l’hôte, pointez dessus et sélectionnez l’icône Copier.To copy the server name or host name, hover over it and select the Copy icon.

Créer le projetCreate the project

  1. À partir de l’invite de commandes, créez un projet Maven nommé sqltest.From the command prompt, create a new Maven project called sqltest.

    mvn archetype:generate "-DgroupId=com.sqldbsamples" "-DartifactId=sqltest" "-DarchetypeArtifactId=maven-archetype-quickstart" "-Dversion=1.0.0" --batch-mode
    
  2. Basculez vers le dossier sqltest et ouvrez pom.xml avec votre éditeur de texte favori.Change the folder to sqltest and open pom.xml with your favorite text editor. Ajoutez le pilote Microsoft JDBC pour SQL Server aux dépendances de votre projet en utilisant le code ci-dessous.Add the Microsoft JDBC Driver for SQL Server to your project's dependencies using the following code.

    <dependency>
        <groupId>com.microsoft.sqlserver</groupId>
        <artifactId>mssql-jdbc</artifactId>
        <version>7.0.0.jre8</version>
    </dependency>
    
  3. Toujours dans pom.xml, ajoutez les propriétés suivantes à votre projet.Also in pom.xml, add the following properties to your project. S’il n’y a pas de section Propriétés, vous pouvez les ajouter après les dépendances.If you don't have a properties section, you can add it after the dependencies.

    <properties>
        <maven.compiler.source>1.8</maven.compiler.source>
        <maven.compiler.target>1.8</maven.compiler.target>
    </properties>
    
  4. Enregistrez et fermez le fichier pom.xml.Save and close pom.xml.

Ajouter du code pour interroger la base de donnéesAdd code to query database

  1. Vous devez déjà disposer d’un fichier appelé App.java dans votre projet Maven, situé à l’emplacement :You should already have a file called App.java in your Maven project located at:

    ..\sqltest\src\main\java\com\sqldbsamples\App.java..\sqltest\src\main\java\com\sqldbsamples\App.java

  2. Ouvrez le fichier et remplacez son contenu par le code suivant.Open the file and replace its contents with the following code. Ensuite, ajoutez les valeurs appropriées pour vos serveur, base de données, utilisateur et mot de passe.Then add the appropriate values for your server, database, user, and password.

    package com.sqldbsamples;
    
    import java.sql.Connection;
    import java.sql.Statement;
    import java.sql.PreparedStatement;
    import java.sql.ResultSet;
    import java.sql.DriverManager;
    
    public class App {
    
        public static void main(String[] args) {
    
            // Connect to database
            String hostName = "your_server.database.windows.net"; // update me
            String dbName = "your_database"; // update me
            String user = "your_username"; // update me
            String password = "your_password"; // update me
            String url = String.format("jdbc:sqlserver://%s:1433;database=%s;user=%s;password=%s;encrypt=true;"
                + "hostNameInCertificate=*.database.windows.net;loginTimeout=30;", hostName, dbName, user, password);
            Connection connection = null;
    
            try {
                connection = DriverManager.getConnection(url);
                String schema = connection.getSchema();
                System.out.println("Successful connection - Schema: " + schema);
    
                System.out.println("Query data example:");
                System.out.println("=========================================");
    
                // Create and execute a SELECT SQL statement.
                String selectSql = "SELECT TOP 20 pc.Name as CategoryName, p.name as ProductName "
                    + "FROM [SalesLT].[ProductCategory] pc "  
                    + "JOIN [SalesLT].[Product] p ON pc.productcategoryid = p.productcategoryid";
    
                try (Statement statement = connection.createStatement();
                ResultSet resultSet = statement.executeQuery(selectSql)) {
    
                    // Print results from select statement
                    System.out.println("Top 20 categories:");
                    while (resultSet.next())
                    {
                        System.out.println(resultSet.getString(1) + " "
                            + resultSet.getString(2));
                    }
                    connection.close();
                }
            }
            catch (Exception e) {
                e.printStackTrace();
            }
        }
    }
    

    Notes

    Cet exemple de code utilise l’exemple de base de données AdventureWorksLT pour SQL Azure.The code example uses the AdventureWorksLT sample database for Azure SQL.

Exécuter le codeRun the code

  1. À l’invite de commande, exécutez l’application.At the command prompt, run the app.

    mvn package -DskipTests
    mvn -q exec:java "-Dexec.mainClass=com.sqldbsamples.App"
    
  2. Vérifiez que les 20 premières lignes ont été retournées et fermez la fenêtre d’application.Verify the top 20 rows are returned and close the app window.

Étapes suivantesNext steps