Statement Outline

Pré-requisitos

A versão do kernel do GaussDB(for MySQL) é 2.0.42.230600 ou posterior.

Precauções

1. Statement Outline está desativada por padrão. Para ativá-la, entre em contato com o atendimento ao cliente.
2. Se a Statement Outline estiver desativada, o desempenho não será afetado. Se houver um grande número de regras depois que a Statement Outline estiver ativada, o desempenho se deteriora.

Descrição

A Statement Outline suporta as dicas do otimizador e as dicas de índice do MySQL 8.0.

Tabela de outline

GaussDB(for MySQL) tem uma tabela de sistema integrada (outline) para armazenar dicas. Esta tabela é criada automaticamente quando o sistema é iniciado. As instruções SQL para criar a tabela são as seguintes.

CREATE TABLE `mysql`.`outline` (
  `Id` bigint(20) NOT NULL AUTO_INCREMENT,
  `Schema_name` varchar(64) COLLATE utf8_bin DEFAULT NULL,
  `Digest` varchar(64) COLLATE utf8_bin NOT NULL,
  `Digest_text` longtext COLLATE utf8_bin,
  `Type` enum('IGNORE INDEX','USE INDEX','FORCE INDEX','OPTIMIZER') CHARACTER SET utf8 COLLATE utf8_general_ci NOT NULL,
  `Scope` enum('','FOR JOIN','FOR ORDER BY','FOR GROUP BY') CHARACTER SET utf8 COLLATE utf8_general_ci DEFAULT '',
  `State` enum('N','Y') CHARACTER SET utf8 COLLATE utf8_general_ci NOT NULL DEFAULT 'Y',
  `Position` bigint(20) NOT NULL,
  `Hint` text COLLATE utf8_bin NOT NULL,
  PRIMARY KEY (`Id`)
) ENGINE=InnoDB
 DEFAULT CHARSET=utf8 COLLATE=utf8_bin STATS_PERSISTENT=0 COMMENT='Statement outline'

Gerenciamento de Statement Outline

Existem seis regras de armazenamento local para gerenciar a Statement Outline.

• add_optimizer_outline

  Adicionar dicas do otimizador

  • Sintaxe

    dbms_outln.add_optimizer_outline(<Schema_name>,<Digest>,<Query_block>,<Hint>,<Query>);

    

    Você pode definir Digest ou Query (instrução SQL original). Se você definir Query, DBMS_OUTLN calculará Digest e Digest_text. É aconselhável definir Query diretamente.

  • Descrição

    Parâmetro	Obrigatório	Tipo	Descrição
    Schema_name	Sim	VARCHAR	Nome do banco de dados ao qual a instrução pertence. Este parâmetro pode ser definido como NULL ou deixado em branco, a instrução não pode ser correspondida.
    Digest	Não	VARCHAR	Valor de hash da instrução. Você pode definir este parâmetro ou Query. Se você não quiser configurá-lo para um valor específico, defina-o como uma cadeia vazia.
    Query_block	Sim	INT	Posição do objeto ao qual a dica se aplica. Intervalo de valores: Maior ou igual a 1
    Hint	Sim	VARCHAR	Nome da dica.
    Query	Não	VARCHAR	Instrução SQL. Você pode definir este parâmetro ou Digest. Se você não quiser configurá-lo para um valor específico, defina-o como uma cadeia vazia. Se ambos estiverem definidos, verifique se Digest e Query correspondem. Se eles não corresponderem, a verificação do parâmetro falhará e a execução falhará.

  • Exemplo

    

• add_index_outline

  Adição de dicas de índice

  • Sintaxe

    dbms_outln.add_index_outline(<Schema_name>,<Digest>,<Position>,<Type>,<Hint>,<Scope>,<Query>);

    

    Você pode definir Digest ou Query (instrução SQL original). Se você definir Query, DBMS_OUTLN calculará Digest e Digest_text. É aconselhável definir Query diretamente.

  • Descrição

    Parâmetro	Obrigatório	Tipo	Descrição
    Schema_name	Sim	VARCHAR	Nome do banco de dados ao qual a instrução pertence. Este parâmetro pode ser definido como NULL ou deixado em branco, a instrução não pode ser correspondida.
    Digest	Não	VARCHAR	Valor de hash da instrução. Defina este parâmetro ou Query. Se você não quiser configurá-lo para um valor específico, defina-o como uma cadeia vazia.
    Position	Sim	INT	Posição da tabela à qual a dica de índice se aplica na instrução. O valor deve ser maior ou igual a 1.
    Type	Sim	ENUM	Tipo de dica. Seu valor pode ser: OPTIMIZER USE INDEX FORCE INDEX IGNORE INDEX
    Hint	Sim	VARCHAR	Nome da dica ou conjunto de nomes de índice. Use vírgulas (,) para separar vários nomes de índices.
    Scope	Sim	ENUM	Escopo da dica. Seu valor pode ser: FOR GROUP BY FOR ORDER BY FOR JOIN Uma cadeia vazia
    Query	Não	VARCHAR	Instrução SQL. Você pode selecionar um ou Digest. Se você não quiser configurá-lo para um valor específico, defina-o como uma cadeia vazia. Se ambos estiverem definidos, verifique se Digest e Query correspondem. Se eles não corresponderem, a verificação do parâmetro falhará e a execução falhará.

  • Exemplo

    call dbms_outln.add_index_outline('outline_db', '', 1, 'USE INDEX', 'ind_1', '',"select * from t1 where t1.col1 =1 and t1.col2 ='xpchild'");

• preview_outline

  Consultar o status da instrução SQL que corresponde à Statement Outline, que pode ser usada para verificação manual.

  • Sintaxe

    dbms_outln.preview_outline(<Schema_name>,<Query>);

  • Descrição

    Parâmetro	Obrigatório	Tipos de dados	Descrição
    Schema_name	Sim	VARCHAR	Nome do banco de dados.
    Query	Sim	VARCHAR	Instrução SQL.

  • Exemplo

    

• show_outline

  Exibição da taxa de acerto na memória de statement outline

  • Sintaxe

    dbms_outln.show_outline();

  • Exemplo

    

    Descrição de HIT e OVERFLOW

    1. HIT indica o número de vezes que a statement outline encontra o bloco de consulta ou a tabela de destino.
    2. OVERFLOW indica o número de vezes que a statement outline não encontra o bloco de consulta ou a tabela de destino.
• del_outline

  Exclusão de statement outline da memória e da tabela.

  • Sintaxe

    dbms_outln.del_outline(<id>);

  • Descrição

    Parâmetro	Obrigatório	Tipo	Descrição
    id	Sim	INT	ID de statement outline, que é o valor na coluna id na tabela mysql.outline. O valor não pode ser deixado em branco.

  • Exemplo

    

    Observação: se a statement outline a ser excluída não existir, o sistema relata um aviso. Você pode executar o comando show warnings; para exibir o conteúdo do aviso.

• flush_outline

  Se você modificar a statement outline na tabela de outline, precisará fazer com que a statement outline entre em vigor novamente.

  • Sintaxe

    dbms_outln.flush_outline();

  • Exemplo

    update mysql.outline set Position = 1 where Id = 18;
    call dbms_outln.flush_outline();

Verificação de função

Para verificar se a estrutura de tópicos da instrução entra em vigor, execute as seguintes etapas:

• Use a interface preview_outline.

  

• Execute o comando EXPLAIN.