O arquivo user.xml controla configurações no nível de usuário, informações da conta e permissões no ApsaraDB for ClickHouse. Este tópico descreve como modificar parâmetros do user.xml com comandos SQL.
Contexto
O ApsaraDB for ClickHouse armazena os padrões globais do cluster em dois arquivos de configuração: config.xml e user.xml.
config.xml: Modifique parâmetros no console do ApsaraDB for ClickHouse. As alterações exigem reinicialização do cluster para entrar em vigor. Para mais detalhes, consulte Configure parâmetros do config.xml.
user.xml: Modifique parâmetros ao se conectar ao cluster e executar comandos SQL. As alterações não exigem reinicialização do cluster. Não é possível modificar esses parâmetros com o
clickhouse-client.
Pré-requisitos
Antes de começar, verifique se:
O cluster está no estado Running.
Community-compatible Edition
Sintaxe
SET GLOBAL ON cluster default <setting_name> = <setting_value>;Para valores booleanos ou strings, coloque setting_value entre aspas simples (').
Para obter a lista completa de configurações compatíveis, consulte Configurações do ClickHouse.
Exemplos
Defina o número máximo de linhas por bloco ao carregar dados de uma tabela:
SET GLOBAL ON cluster default max_block_size = 10000;Ative a análise paralela com preservação de ordem para o formato de dados:
SET GLOBAL ON cluster default input_format_parallel_parsing = 'True';Visualize configurações atuais
Para visualizar todas as configurações definidas atualmente no user.xml do cluster, execute:
SELECT * FROM system.settings;Enterprise Edition
Os clusters da Enterprise Edition usam o sistema nativo de controle de acesso baseado em SQL do ClickHouse. A sintaxe varia conforme o escopo e a persistência da alteração.
Para consultar os valores válidos de setting_name e setting_value, consulte Configurações principais e Configurações de complexidade de consulta.
Defina configurações temporárias para a sessão atual
Use SET para aplicar uma configuração apenas à sessão atual.
As configurações no nível de sessão não são persistentes e tornam-se inválidas após a desconexão do cluster.
SET <setting_name> = <setting_value>;Exemplo: Ative o recurso de live view para a sessão atual.
SET allow_experimental_live_view = 1;Tornar configurações persistentes para uma única conta
Use ALTER USER para configurar persistentemente definições, informações da conta ou permissões de um usuário específico.
Execute esta instrução com uma conta privilegiada ou que possua a permissão ACCESS MANAGEMENT.
A instrução
ALTER USERredefine a configuração do usuário.As configurações aplicadas com
ALTER USERsão persistentes, mas não entram em vigor na sessão atual. Reconecte-se ao cluster para aplicar as alterações.
Sintaxe:
ALTER USER <user_name> SETTINGS <setting_name> = <setting_value>;Exemplo: Limite o uso de memória do usuário Nancy a 4 GB.
ALTER USER Nancy SETTINGS max_memory_usage_for_user = 4294967296;Tornar configurações persistentes para todas as contas
Use CREATE SETTINGS PROFILE para aplicar configurações a todos os usuários do cluster.
Execute esta instrução com uma conta privilegiada ou que possua a permissão ACCESS MANAGEMENT.
As configurações aplicadas com
CREATE SETTINGS PROFILEsão persistentes, mas não entram em vigor na sessão atual. Reconecte-se ao cluster para aplicar as alterações.
Sintaxe:
CREATE SETTINGS PROFILE <profile_name> SETTINGS <setting_name> = <setting_value> TO ALL;Exemplo: Limite o tempo de execução de consultas a 10 segundos para todos os usuários.
CREATE SETTINGS PROFILE max_execution_time_profile SETTINGS max_execution_time = 10 TO ALL;Verifique se as configurações são persistentes
Sintaxe:
SHOW SETTINGS LIKE '%<settings_name>%';Exemplo: Verifique se allow_experimental_live_view foi persistido.
SHOW SETTINGS LIKE '%allow_experimental_live_view%';