Tablestore:Operações DML

Inserção de linha única

INSERT INTO user_table VALUES (1, 'value1', 100);

Inserção em lote de várias linhas na mesma chave de partição

É possível inserir atomicamente em lote linhas que compartilham a mesma chave de partição, com limite de 200 linhas por lote. O exemplo a seguir usa o esquema de tabela user_table(pk1 BIGINT, pk2 VARCHAR(1024), value BIGINT), em que pk1 é a chave de partição. Como ambas as linhas têm pk1 = 1, elas pertencem à mesma partição.

INSERT INTO user_table VALUES (1, 'attr1', 100), (1, 'attr2', 200);

Observações de uso

• Conflito de chave primária: a inserção de uma linha com chave primária já existente retorna o código de erro OTSParameterInvalid com uma mensagem contendo Duplicate entry for key 'PRIMARY'. Os dados existentes não são sobrescritos.

• Inserção em lote entre partições: todas as linhas em um INSERT em lote devem compartilhar a mesma chave de partição. Inserções em lote com chaves de partição diferentes falham.

• Limite de tamanho do lote: um INSERT em lote com mais de 200 linhas é rejeitado.

• Linhas afetadas: um INSERT de linha única retorna 1 em caso de sucesso. Um INSERT em lote de N linhas retorna N em caso de sucesso. Conflitos de chave primária não retornam linhas afetadas e geram erro diretamente.

Atualização com valores constantes

Atualize uma ou mais colunas simultaneamente.

-- Single-column update
UPDATE user_table SET attr_col = 999 WHERE pk_col = 1;

-- Multi-column update
UPDATE user_table SET c1 = 10, c2 = 20, c3 = 'updated' WHERE id = 1;

-- Composite primary key update. The column order in the WHERE clause can differ from the key definition order.
UPDATE user_table SET value = 999 WHERE pk2 = 2 AND pk1 = 1;

Incremento e decremento atômicos

Incremente ou decremente atomicamente colunas de atributo inteiras (BIGINT). Esse recurso é útil para contadores e casos de uso semelhantes. Apenas colunas de atributo BIGINT são compatíveis.

-- Increment by 1
UPDATE user_table SET counter = counter + 1 WHERE id = 1;

-- Increment by a specified value
UPDATE user_table SET counter = counter + 10 WHERE id = 1;

-- Decrement
UPDATE user_table SET counter = counter - 5 WHERE id = 1;

Definir uma coluna de atributo como NULL

Definir uma coluna de atributo como NULL remove a coluna da linha em vez de armazenar um valor NULL.

UPDATE user_table SET attr_col = NULL WHERE pk_col = 1;

Observações de uso

• A cláusula WHERE deve especificar a chave primária completa com condições de igualdade: os casos a seguir não são compatíveis e retornam o código de erro OTSParameterInvalid ou OTSUnsupportOperation:

  • A cláusula WHERE não contém a chave primária completa.

  • A cláusula WHERE referencia colunas fora da chave primária.

  • A cláusula WHERE usa condições de intervalo (>, <, BETWEEN e operadores similares).

  • A cláusula WHERE usa IN, LIKE, OR, != ou outras condições de não igualdade.

  • A cláusula WHERE inclui condições de coluna de atributo além da chave primária completa.

• Colunas de chave primária não podem ser modificadas: o UPDATE não permite alterar valores de colunas de chave primária por meio do SET.

• Linha inexistente: a atualização de uma linha inexistente é concluída silenciosamente com 0 linhas afetadas e nenhum erro.

-- Single primary key
DELETE FROM user_table WHERE pk_col = 1;

-- String primary key
DELETE FROM user_table WHERE id = 'abc';

-- Composite primary key
DELETE FROM user_table WHERE pk1 = 1 AND pk2 = 1;

-- Composite primary key with different column order
DELETE FROM user_table WHERE pk2 = 2 AND pk1 = 1;

Observações de uso

• A cláusula WHERE deve especificar a chave primária completa com condições de igualdade: aplicam-se as mesmas restrições do UPDATE. Cláusula WHERE ausente, chave primária parcial, condições em colunas fora da chave primária, condições de intervalo, IN, LIKE, OR e condições adicionais de coluna de atributo não são compatíveis.

• Linha inexistente: a exclusão de uma linha inexistente é concluída silenciosamente com 0 linhas afetadas e nenhum erro.

Limitações de sintaxe SQL

As seguintes sintaxes SQL não são compatíveis:

Limitações de tipo de dados

Opções e restrições de coluna

O CREATE TABLE aceita apenas as seguintes opções de coluna: PRIMARY KEY, NOT NULL, NULL, DEFAULT VALUE e ON UPDATE. AUTO_INCREMENT, UNIQUE, CHECK, COMMENT e outras opções de coluna não são compatíveis.

Quanto a restrições, apenas PRIMARY KEY é compatível. UNIQUE, FOREIGN KEY, CHECK e outras restrições não são compatíveis.

Limitações de tipo especial de tabela

Tabelas vinculadas a índices de pesquisa e tabelas de alias não aceitam nenhuma operação DML (INSERT, UPDATE, DELETE).