Jouer avec Microsoft SQL Server 2022 avec Docker

Et oui, rien de moins. Nous allons installer un Microsoft SQL Server 2022 sur notre machine, installer aussi SQL Server Management Studio et nous amuser avec un petit script PowerShell ; le tout avec Docker, évidemment. Si c'est Oracle qu'il vous faut, j'ai aussi écrit Faire tourner Oracle Database Server dans un container Docker.

Le repository Docker officiel de Microsoft SQL Server se trouve sur https://hub.docker.com/_/microsoft-mssql-server.

Commençons par télécharger et lancer une instance de SQL Server 2022 avec l'instruction suivante :

$ docker run -e "ACCEPT_EULA=Y" -e "MSSQL_SA_PASSWORD=2Secure*Password2" -p 1433:1433 --name sqlserverdb -h mysqlserver -d mcr.microsoft.com/mssql/server:2022-latest▋

Avec la commande ci-dessus, nous acceptons les termes du End-User License Agreement et nous définissons le mot de passe de l'utilisateur SA à 2Secure*Password2.

Le port que nous utiliserons sur notre host est le port 1433 (mappé sur le port 1433 du container), notre instance SQL Server s'appellera sqlserverdb (nom interne utilisé par Docker) et nous nommerons notre host mysqlserver.

Nous pouvons vérifier la liste des containers en cours d'exécution grâce à docker container list :

$ docker container list
[...] IMAGE                                       [...] NAMES
[...] mcr.microsoft.com/mssql/server:2022-latest  [...] sqlserverdb▋

Maintenant, si vous n'avez pas encore SQL Server Management Studio (aussi appelé SSMS) sur votre machine, téléchargez-le gratuitement depuis https://learn.microsoft.com/en-us/sql/ssms/download-sql-server-management-studio-ssms?view=sql-server-ver16.

Lancez le programme d'installation et attendez qu'il soit installé sur votre machine.

Démarrez maintenant SSMS (vous le trouverez dans votre menu Start de Windows) :

Utilisez les valeurs ci-dessous pour l'authentification :

Cliquez sur le bouton Connect et SSMS sera connecté à votre instance Docker. Il est temps de créer notre base de données.

Créer la base de données, la table et ajouter quelques enregistrements​

Une fois connecté dans SSMS, exécutez la query suivante pour créer une base de données d'exemple MyDB, créer une table appelée dbo.Person et ajouter quelques enregistrements.

Pour ce faire, cliquez sur le bouton New Query (ou pressez CTRL-N), collez le SQL ci-dessous puis cliquez sur le bouton Execute (ou pressez F5).

USE [master]
GO

CREATE DATABASE [MyDB]
 CONTAINMENT = NONE?
 ON  PRIMARY
( NAME = N'MyDB', FILENAME = N'/var/opt/mssql/data/MyDB.mdf' , SIZE = 8192KB , MAXSIZE = UNLIMITED, FILEGROWTH = 65536KB )?
 LOG ON
( NAME = N'MyDB_log', FILENAME = N'/var/opt/mssql/data/MyDB_log.ldf' , SIZE = 8192KB , MAXSIZE = 2048GB , FILEGROWTH = 65536KB )?
 WITH CATALOG_COLLATION = DATABASE_DEFAULT?
GO

USE [MyDB]
GO

CREATE TABLE [dbo].[Person](
 [FirstName] [varchar](50) NULL,?
 [LastName] [varchar](50) NULL
) ON [PRIMARY]?
GO

INSERT INTO dbo.Person (LastName, FirstName) VALUES
 ('Avonture', 'Christophe'),
 ('Doe', 'John');
GO

Félicitations, vous avez créé une base de données MyDB avec une table dbo.Person :

Écrire un script PowerShell et se connecter à la base de données​

Ce n'est probablement pas la meilleure façon d'interroger une base SQL Server, l'exemple vient de Stack Overflow... Si vous êtes plutôt du genre Excel, voyez MS Excel - Se connecter à une base de données SQL Server, exécuter une requête et récupérer les résultats.

Comme exemple, nous allons créer un script PowerShell appelé connect.ps1 pour illustrer comment interroger notre nouvelle base de données :

$SqlServer = 'localhost,1433';
$SqlDatabase = 'MyDB';

$SqlConnectionString = 'Data Source={0};Initial Catalog={1};User Id=SA;Password=2Secure*Password2;' -f $SqlServer, $SqlDatabase;?
$SqlQuery = "SELECT FirstName, LastName FROM dbo.Person ORDER BY LastName;";

$SqlConnection = New-Object -TypeName System.Data.SqlClient.SqlConnection -ArgumentList $SqlConnectionString;?

$SqlCommand = $SqlConnection.CreateCommand();?
$SqlCommand.CommandText = $SqlQuery;

$SqlConnection.Open();
$SqlDataReader = $SqlCommand.ExecuteReader();?

Write-Host "Here is the content of dbo.Person"
Write-Host "---------------------------------"
Write-Host ""

while ($SqlDataReader.Read()) {?
    Write-Host $SqlDataReader['LastName'] $SqlDataReader['FirstName'];?
}

$SqlConnection.Close();
$SqlConnection.Dispose();

Write-Host ""

Lancez une console DOS ou PowerShell et exécutez cette commande : powershell -executionpolicy bypass -File .\connect.ps1.

Nous avons maintenant validé que votre base de données est fonctionnelle et accessible. À vous de vous approprier cet exemple !