Share via


Configurar parâmetros de servidor no Banco de Dados do Azure para MariaDB usando a CLI do Azure

Importante

O Banco de Dados do Azure para MariaDB está no caminho da aposentadoria. É altamente recomendável migrar para o Banco de Dados do Azure para MySQL. Para obter mais informações sobre como migrar para o Banco de Dados do Azure para MySQL, consulte O que está acontecendo com o Banco de Dados do Azure para MariaDB?.

Você pode listar, mostrar e atualizar parâmetros de configuração para um Banco de Dados do Azure para servidor MariaDB usando a CLI do Azure, o utilitário de linha de comando do Azure. Um subconjunto de configurações de mecanismo é exposto no nível do servidor e pode ser modificado.

Nota

Os parâmetros do servidor podem ser atualizados globalmente ao nível do servidor ao utilizar a CLI do Azure, o PowerShell ou o portal do Azure.

Pré-requisitos

Para percorrer este guia de instruções, você precisa:

Listar parâmetros de configuração do servidor para o Banco de Dados do Azure para o servidor MariaDB

Para listar todos os parâmetros modificáveis em um servidor e seus valores, execute o comando az mariadb server configuration list .

Você pode listar os parâmetros de configuração do servidor para o servidor mydemoserver.mariadb.database.azure.com em grupo de recursos myresourcegroup.

az mariadb server configuration list --resource-group myresourcegroup --server mydemoserver

Para a definição de cada um dos parâmetros listados, consulte a seção de referência do MariaDB em Variáveis de sistema do servidor.

Mostrar detalhes do parâmetro de configuração do servidor

Para mostrar detalhes sobre um parâmetro de configuração específico para um servidor, execute o comando az mariadb server configuration show .

Este exemplo mostra detalhes do parâmetro de configuração do servidor slow_query_log para mydemoserver.mariadb.database.azure.com de servidor em grupo de recursos myresourcegroup.

az mariadb server configuration show --name slow_query_log --resource-group myresourcegroup --server mydemoserver

Modificar um valor de parâmetro de configuração do servidor

Você também pode modificar o valor de um determinado parâmetro de configuração do servidor, que atualiza o valor de configuração subjacente para o mecanismo de servidor MariaDB. Para atualizar a configuração, use o comando az mariadb server configuration set .

Para atualizar o parâmetro de configuração do servidor slow_query_log do servidor mydemoserver.mariadb.database.azure.com em grupo de recursos myresourcegroup.

az mariadb server configuration set --name slow_query_log --resource-group myresourcegroup --server mydemoserver --value ON

Se você quiser redefinir o valor de um parâmetro de configuração, omita o parâmetro opcional --value e o serviço aplica o valor padrão. Para o exemplo acima, seria como:

az mariadb server configuration set --name slow_query_log --resource-group myresourcegroup --server mydemoserver

Esse código redefine a configuração slow_query_log para o valor padrão OFF.

Definição de parâmetros não listados

Se o parâmetro de servidor que você deseja atualizar não estiver listado no portal do Azure, você pode, opcionalmente, definir o parâmetro no nível de conexão usando init_connect. Isso define os parâmetros do servidor para cada cliente que se conecta ao servidor.

Atualize o parâmetro de configuração do servidor init_connect do servidor mydemoserver.mariadb.database.azure.com em grupo de recursos myresourcegroup para definir valores como conjunto de caracteres.

az mariadb server configuration set --name init_connect --resource-group myresourcegroup --server mydemoserver --value "SET character_set_client=utf8;SET character_set_database=utf8mb4;SET character_set_connection=latin1;SET character_set_results=latin1;"

Trabalhando com o parâmetro de fuso horário

Preenchendo as tabelas de fuso horário

As tabelas de fuso horário em seu servidor podem ser preenchidas chamando o mysql.az_load_timezone procedimento armazenado de uma ferramenta como a linha de comando MariaDB ou MariaDB Workbench.

Nota

Se você estiver executando o comando do MariaDB Workbench, talvez seja necessário desativar o modo de atualização segura primeiro usando SET SQL_SAFE_UPDATES=0;o mysql.az_load_timezone .

CALL mysql.az_load_timezone();

Importante

Você deve reiniciar o servidor para garantir que as tabelas de fuso horário sejam preenchidas corretamente. Para reiniciar o servidor, use o portal do Azure ou a CLI.

Para exibir os valores de fuso horário disponíveis, execute o seguinte comando:

SELECT name FROM mysql.time_zone_name;

Definindo o fuso horário de nível global

O fuso horário de nível global pode ser definido usando o comando az mariadb server configuration set .

O comando a seguir atualiza o parâmetro de configuração do servidor time_zone do servidor mydemoserver.mariadb.database.azure.com em grupo de recursos myresourcegroup para EUA/Pacífico.

az mariadb server configuration set --name time_zone --resource-group myresourcegroup --server mydemoserver --value "US/Pacific"

Definindo o fuso horário do nível da sessão

O fuso horário de nível de sessão pode ser definido executando o comando a SET time_zone partir de uma ferramenta como a linha de comando MariaDB ou MariaDB Workbench. O exemplo abaixo define o fuso horário como o fuso horário EUA/Pacífico .

SET time_zone = 'US/Pacific';

Consulte a documentação do MariaDB para Funções de data e hora.

Próximos passos