PolarDB:Instruções de uso

Sintaxe

CREATE {DATABASE | SCHEMA} [IF NOT EXISTS] db_name
[create_option] ...
create_option: [DEFAULT] {
CHARACTER SET [=] charset_name
| COLLATE [=] collation_name
| ENCRYPTION [=] {'Y' | 'N'}
| DIST_DB [=] {'Y' | 'N'}
}

Exemplos

Crie um banco de dados chamado test1 e permita a criação de tabelas particionadas de cluster multi-master nesse banco de dados.

CREATE DATABASE test1 DIST_DB='Y';

Modo de sharding de banco de dados

A instrução CREATE TABLE cria tabelas. Em um banco de dados marcado como DIST_DB='Y', utilize DBDISTRIBUTION para especificar o método de distribuição das tabelas particionadas de cluster multi-master. Se o número de shards não for definido explicitamente, o sistema o determinará automaticamente com base na configuração do cluster.

Sintaxe

CREATE [TEMPORARY] TABLE [IF NOT EXISTS] tbl_name
    (create_definition,...)
    [table_options]
    [dbdistribution_options]

dbdistribution_options:
    DBDISTRIBUTION BY
        { [LINEAR] HASH(expr)
        | [LINEAR] KEY [ALGORITHM={1 | 2}] (column_list)
        | RANGE{(expr) | COLUMNS(column_list)}
        | LIST{(expr) | COLUMNS(column_list)} }
    [(dbdistribution_definition [, dbdistribution_definition] ...)]

dbdistribution_definition:
    DBDISTRIBUTION distribution_name
        [VALUES
            {LESS THAN {(expr | value_list) | MAXVALUE}
            |
            IN (value_list)}]
        [[STORAGE] ENGINE [=] engine_name]
        [COMMENT [=] 'string' ]
        [DATA DIRECTORY [=] 'data_dir']
        [INDEX DIRECTORY [=] 'index_dir']
        [MAX_ROWS [=] max_number_of_rows]
        [MIN_ROWS [=] min_number_of_rows]
        [TABLESPACE [=] tablespace_name]

Exemplos:

• Tabela única regular

  CREATE database test;
  CREATE TABLE t1(
   id bigint NOT NULL, 
   name varchar(30), 
   PRIMARY key(id)
  );

• Tabelas particionadas multi-master com suporte ao modo de sharding de banco de dados

  Uso de função hash para divisão

  Crie uma tabela particionada de cluster multi-master e utilize a coluna id para divisão por hash. Os shards de dados são distribuídos entre os nós de leitura e escrita do cluster.

  CREATE TABLE dist1(
   id bigint NOT NULL, 
   c1 int, 
   c2 varchar(30), 
   PRIMARY key(id)
  ) dbdistribution BY hash(id);

  Sharding LIST

  O tipo list consiste em uma coleção de listas de valores de enumeração, atendendo aos requisitos de sharding por enumeração. No sharding list, utiliza-se DBDISTRIBUTION BY LIST(expr) para definição, onde expr é a abreviação de expressão e representa o valor de uma coluna ou uma expressão baseada nesse valor. É necessário que expr retorne um valor inteiro. Em seguida, defina cada shard com VALUES IN (value_list), sendo value_list uma lista de valores inteiros separados por vírgulas.

  CREATE TABLE t1 (
      id INT NOT NULL,
      store_id INT,
      partition_no INT,
      PRIMARY key(id, partition_no)
  ) DBDISTRIBUTION BY LIST(partition_no) (
    DBDISTRIBUTION a VALUES IN (1),
    DBDISTRIBUTION b VALUES IN (2)
  );

  Sharding LIST-COLUMNS

  O sharding list column assemelha-se muito ao sharding list e é definido por DBDISTRIBUTION BY LIST COLUMNS(column_list), onde column_list pode conter um ou mais nomes de colunas em vez de expressões. Na prática, columns() não aceita outras expressões além de nomes de colunas. O sharding list columns não se limita mais a colunas inteiras. Os tipos aplicáveis incluem:

  • Todos os tipos inteiros: TINYINT, SMALLINT, MEDIUMINT, INT (INTEGER) e BIGINT.

  • Outros tipos numéricos: DECIMAL e FLOAT, por exemplo, não são suportados.

  • Tipos de data: DATE e DATETIME.

  • Tipos de string: CHAR, VARCHAR, BINARY e VARBINARY. TEXT e BLOB não são suportados.

  CREATE TABLE t3 (
      id INT NOT NULL,
      store_id INT,
      partition_no varchar(20),
      PRIMARY key(id, partition_no)
  ) DBDISTRIBUTION BY LIST COLUMNS (partition_no) (
    DBDISTRIBUTION a values in ('id_1'),
    DBDISTRIBUTION b values in ('id_2')
  );

ALTER TABLE

A sintaxe comum do MySQL para ALTER TABLE é suportada. Tabelas particionadas de cluster multi-master não permitem modificar regras de distribuição nem executar certas operações que exigem reorganização de shards. Para limites específicos, consulte os limites de desenvolvimento neste tópico.

CREATE INDEX

A sintaxe comum do MySQL para CREATE INDEX é suportada. Ao criar uma chave primária ou índice único, o índice deve conter todas as chaves de distribuição.