Se connecter à Azure Database pour MySQL avec la redirection

S’APPLIQUE À : Azure Database pour MySQL - Serveur unique

Cet article explique comment connecter une application à votre serveur Azure Database pour MySQL avec le mode de redirection. La redirection réduit la latence réseau entre les applications clientes et les serveurs MySQL en permettant aux applications de se connecter directement aux nœuds du serveur back-end.

Avant de commencer

Connectez-vous au portail Azure. Créez un serveur Azure Database pour MySQL avec un moteur version 5.6, 5.7 ou 8.0.

Pour plus d’informations, consultez la rubrique relative à la création d’un serveur Azure Database pour MySQL à l’aide du portail Azure ou d’Azure CLI.

Activer la redirection

Sur votre serveur Azure Database pour MySQL, configurez le paramètre redirect_enabled sur ON pour autoriser les connexions avec le mode de redirection. Pour mettre à jour ce paramètre de serveur, utilisez le portail Azure ou Azure CLI.

PHP

La prise en charge de la redirection dans les applications PHP est disponible dans l’extension mysqlnd_azure, développée par Microsoft.

L’extension mysqlnd_azure peut être ajoutée aux applications PHP via PECL, et il est vivement recommandé d’installer et de configurer l’extension par le biais du package PECL officiel.

Logique de redirection

Le comportement de redirection est déterminé par la valeur de mysqlnd_azure.enableRedirect. Le tableau ci-dessous décrit le comportement de la redirection en fonction de la valeur de ce paramètre à partir de la version 1.1.0+ .

Si vous utilisez une version antérieure de l’extension mysqlnd_azure (version 1.0.0-1.0.3), le comportement de la redirection est déterminé par la valeur de mysqlnd_azure.enabled. Les valeurs valides sont off (agit de la même façon que le comportement décrit dans le tableau ci-dessous) et on (agit comme preferred dans le tableau ci-dessous).

Pour une connexion réussie à Azure Database pour MySQL - Serveur unique à l’aide de mysqlnd_azure.enableRedirect, vous devez suivre les étapes obligatoires de combinaison de votre certificat racine conformément aux exigences de conformité. Pour plus d’informations, consultez ce lien.

Les sections suivantes du document décrivent l’installation de l’extension mysqlnd_azure à l’aide de PECL et la définition de la valeur de ce paramètre.

Confirmer la redirection

Vous pouvez également confirmer que la redirection est configurée avec l’exemple de code PHP ci-dessous. Créez un fichier PHP nommé mysqlConnect.php et collez-y le code ci-dessous. Mettez à jour le nom du serveur, le nom d’utilisateur et le mot de passe en les remplaçant par vos propres valeurs.

<?php
$host = '<yourservername>.mysql.database.azure.com';
$username = '<yourusername>@<yourservername>';
$password = '<yourpassword>';
$db_name = 'testdb';
  echo "mysqlnd_azure.enableRedirect: ", ini_get("mysqlnd_azure.enableRedirect"), "\n";
  $db = mysqli_init();
  //The connection must be configured with SSL for the redirection test
  $link = mysqli_real_connect ($db, $host, $username, $password, $db_name, 3306, NULL, MYSQLI_CLIENT_SSL);
  if (!$link) {
     die ('Connect error (' . mysqli_connect_errno() . '): ' . mysqli_connect_error() . "\n");
  }
  else {
    echo $db->host_info, "\n"; //if redirection succeeds, the host_info will differ from the hostname you used used to connect
    $res = $db->query('SHOW TABLES;'); //test query with the connection
    print_r ($res);
    $db->close();
  }
?>

Étapes suivantes

• Pour plus d’informations sur les chaînes de connexion, consultez Chaînes de connexions.