Conectar-se ao Banco de Dados do Azure para MySQL com redirecionamento

APLICA-SE A: Banco de Dados do Azure para MySQL – Servidor Único

Este artigo explica como conectar um aplicativo ao servidor do Banco de Dados do Azure para MySQL com o modo de redirecionamento. O redirecionamento reduz a latência de rede entre os aplicativos cliente e os servidores MySQL, permitindo que os aplicativos se conectem diretamente aos nós do servidor back-end.

Antes de começar

Entre no portal do Azure. Crie um servidor do Banco de Dados do Azure para MySQL com a versão do mecanismo 5.6, 5.7 ou 8.0.

Para obter detalhes, consulte como criar um servidor de Banco de Dados do Azure para MySQL usando o portal do Azure ou a CLI do Azure.

Habilitar redirecionamento

No servidor de Banco de Dados do Azure para MySQL, configure o parâmetro redirect_enabled como ON para permitir conexões com o modo de redirecionamento. Para atualizar esse parâmetro de servidor, use o portal do Azure ou CLI do Azure.

PHP

O suporte para redirecionamento nos aplicativos PHP está disponível por meio da extensão mysqlnd_azure, desenvolvida pela Microsoft.

A extensão mysqlnd_azure está disponível para ser adicionada aos aplicativos PHP por meio do PECL, e é altamente recomendável instalar e configurar a extensão por meio do pacote de PECL publicado oficialmente.

Lógica de redirecionamento

O comportamento de redirecionamento é determinado pelo valor de mysqlnd_azure.enableRedirect. A tabela a seguir descreve o comportamento de redirecionamento com base no valor desse parâmetro a partir da versão 1.1.0+ .

Se você estiver usando uma versão mais antiga da extensão mysqlnd_azure (versão 1.0.0-1.0.3), o comportamento de redirecionamento será determinado pelo valor de mysqlnd_azure.enabled. Os valores válidos são off (atua da mesma forma que o comportamento descrito na tabela abaixo) e on (atua como preferred na tabela abaixo).

Para uma conexão bem-sucedida com o servidor único do Banco de Dados do Azure para MySQL usando mysqlnd_azure.enableRedirect, você precisará seguir as etapas obrigatórias de combinação do certificado raiz de acordo com os requisitos de conformidade. Para mais detalhes, acesse o link.

As seções subsequentes do documento descrevem como instalar a extensão mysqlnd_azure usando o PECL e definir o valor desse parâmetro.

Confirme o redirecionamento

Você também pode confirmar se o redirecionamento está configurado com o exemplo de código PHP abaixo. Crie um arquivo PHP chamado mysqlConnect.php e cole o código abaixo. Atualize o nome do servidor, o nome de usuário e a senha com seus próprios dados.

<?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();
  }
?>

Próximas etapas

• Para saber mais sobre cadeias de conexão, confira Cadeias de Conexão.