Struct testcontainers_modules::mssql_server::MssqlServer

pub struct MssqlServer { /* private fields */ }

Available on crate feature mssql_server only.

Microsoft SQL Server module for testcontainers.

This module is based on the official Microsoft SQL Server for Linux Docker image. Only amd64 images are available for SQL Server. If you use Apple silicon machines, you need to configure Rosetta emulation.

• Change Docker Desktop settings on Mac | Docker Docs

Example

use testcontainers::clients;
use testcontainers_modules::mssql_server;

let docker = clients::Cli::default();
let mssql_server = docker.run(mssql_server::MssqlServer::default());
let ado_connection_string = format!(
   "Server=tcp:127.0.0.1,{};Database=test;User Id=sa;Password=yourStrong(!)Password;TrustServerCertificate=True;",
   mssql_server.get_host_port_ipv4(1433)
);

Environment variables

Refer to the documentation for a complite list of environment variables.

Following environment variables are required. A image provided by this module has default values for them.

ACCEPT_EULA

You need to accept the End-User Licensing Agreement before using the SQL Server image provided by this module. To accept EULA, you can set this environment variable to Y. The default value is Y.

MSSQL_SA_PASSWORD

The SA user password. This password is required to conform to the strong password policy. The default value is yourStrong(!)Password.

MSSQL_PID

The edition of SQL Server. The default value is Developer, which will run the container using the Developer Edition.

Implementations

impl MssqlServer

pub fn with_sa_password(self, password: impl Into<String>) -> Self

Sets the password as MSSQL_SA_PASSWORD.

Trait Implementations

impl Debug for MssqlServer

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for MssqlServer

fn default() -> Self

Returns the “default value” for a type.

impl Image for MssqlServer

type Args = ()

A type representing the arguments for an Image.

fn name(&self) -> String

The name of the docker image to pull from the Docker Hub registry.

fn tag(&self) -> String

Implementations are encouraged to include a tag that will not change (i.e. NOT latest) in order to prevent test code from randomly breaking because the underlying docker suddenly changed.

fn ready_conditions(&self) -> Vec<WaitFor>

Returns a list of conditions that need to be met before a started container is considered ready.

fn env_vars(&self) -> Box<dyn Iterator<Item = (&String, &String)> + '_>

There are a couple of things regarding the environment variables of images:

fn volumes(&self) -> Box<dyn Iterator<Item = (&String, &String)> + '_>

There are a couple of things regarding the volumes of images:

fn entrypoint(&self) -> Option<String>

Returns the entrypoint this instance was created with.

fn expose_ports(&self) -> Vec<u16>

Returns the ports that needs to be exposed when a container is created.

fn exec_after_start(&self, cs: ContainerState) -> Vec<ExecCommand>

Returns the commands that needs to be executed after a container is started i.e. commands to be run in a running container.