SnowConvert AI - Vertica - CREATE TABLE¶

Order by¶

No Vertica, a cláusula ORDER BY especifica como os dados são classificados fisicamente dentro de uma superprojeção, uma estrutura de armazenamento otimizada para uma tabela. Essa ordenação física explícita na criação da tabela não é diretamente suportada no Snowflake. Para mais informações, consulte SSC-EWI-VT0002.

CREATE TABLE metrics 
(
  metric_id INT,
  business_unit VARCHAR(100),
  metric_category VARCHAR(50) NOT NULL,
  measurement_date DATE NOT NULL
)
ORDER BY measurement_date, business_unit, metric_category;

CREATE TABLE metrics
(
  metric_id INT,
  business_unit VARCHAR(100),
  metric_category VARCHAR(50) NOT NULL,
  measurement_date DATE NOT NULL
)
!!!RESOLVE EWI!!! /*** SSC-EWI-VT0002 - ORDER BY TABLE OPTION IS NOT SUPPORTED IN SNOWFLAKE ***/!!!
ORDER BY measurement_date, business_unit, metric_category
COMMENT = '{ "origin": "sf_sc", "name": "snowconvert", "version": {  "major": 0,  "minor": 0,  "patch": "0" }, "attributes": {  "component": "vertica",  "convertedOn": "06/17/2025",  "domain": "no-domain-provided" }}';

Cláusulas de projeções¶

As projeções do Vertica são um mecanismo para definir e manter a ordem de classificação física dos dados no disco, otimizando assim o desempenho da consulta para padrões de acesso específicos. No entanto, o Snowflake usa uma estratégia de armazenamento e otimização fundamentalmente diferente. Os dados no Snowflake são divididos automaticamente em micropartições imutáveis, que são então organizadas e gerenciadas pelo serviço de nuvem.

Embora possa existir uma ordem inerente dentro dessas micropartições devido à inserção ou a aplicação de chaves de clustering, o otimizador de consulta do Snowflake e sua arquitetura subjacente foram feitos para remover essas micropartições de forma eficiente durante a execução da consulta, independentemente de uma ordem de classificação global pré-definida. Essa abordagem, combinada com cache automático e um formato de armazenamento colunar, permite que o Snowflake tenha alto desempenho sem exigir que os usuários definam e gerenciem manualmente estruturas de dados físicas, como as projeções de Vertica. Isso simplifica o gerenciamento de dados e é uma forma de otimizar para uma gama mais ampla de padrões de consulta sem definições de classificação físicas explícitas.

Por esses motivos, as seguintes cláusulas não são necessárias no Snowflake e são removidas do código original:

[ segmentation-spec ]
[ KSAFE [safety] ]
[ partition-clause]

Cláusula “Inherited Schema Privileges”¶

INCLUDE SCHEMA PRIVILEGES é um recurso específico do Vertica que controla como os privilégios são herdados, neste caso, potencialmente do nível do esquema. O Snowflake não tem um equivalente direto para essa cláusula na sintaxe CREATE TABLE. No Snowflake, os privilégios são gerenciados explicitamente por meio de instruções GRANT.

CREATE TABLE metrics 
(
  metric_id INT,
  business_unit VARCHAR(100),
  metric_category VARCHAR(50) NOT NULL,
  measurement_date DATE NOT NULL
)
INCLUDE SCHEMA PRIVILEGES;

CREATE TABLE metrics
(
  metric_id INT,
  business_unit VARCHAR(100),
  metric_category VARCHAR(50) NOT NULL,
  measurement_date DATE NOT NULL
)
!!!RESOLVE EWI!!! /*** SSC-EWI-VT0001 - INHERITED PRIVILEGES CLAUSE IS NOT SUPPORTED IN SNOWFLAKE ***/!!!
INCLUDE SCHEMA PRIVILEGES
COMMENT = '{ "origin": "sf_sc", "name": "snowconvert", "version": {  "major": 0,  "minor": 0,  "patch": "0" }, "attributes": {  "component": "vertica",  "convertedOn": "06/17/2025",  "domain": "no-domain-provided" }}';

IDENTITY - AUTO_INCREMENT¶

Cria uma coluna de tabela com valores gerados e gerenciados automaticamente pelo banco de dados. Você não pode alterar ou carregar valores nesta coluna. Essa restrição só pode ser definida em uma coluna da tabela.

CREATE TABLE customers (
  id AUTO_INCREMENT(1, 2),
  name VARCHAR(50)
);

CREATE TABLE customers2 (
  id IDENTITY(1, 2),
  name VARCHAR(50)
);

CREATE TABLE customers (
  id INT AUTOINCREMENT(1, 2) ORDER,
  name VARCHAR(50)
)
COMMENT = '{ "origin": "sf_sc", "name": "snowconvert", "version": {  "major": 0,  "minor": 0,  "patch": "0" }, "attributes": {  "component": "vertica",  "convertedOn": "06/17/2025",  "domain": "no-domain-provided" }}';

CREATE TABLE customers2 (
  id INT IDENTITY(1, 2) ORDER,
  name VARCHAR(50)
)
COMMENT = '{ "origin": "sf_sc", "name": "snowconvert", "version": {  "major": 0,  "minor": 0,  "patch": "0" }, "attributes": {  "component": "vertica",  "convertedOn": "06/17/2025",  "domain": "no-domain-provided" }}';

Uma restrição CHECK¶

The CHECK clause in Vertica requires new or updated rows to satisfy a Boolean expression. Snowflake supports CHECK constraints with deterministic, scalar expressions. SnowConvert migrates valid CHECK constraints directly to Snowflake and flags unsupported expressions (user-defined functions, non-deterministic functions) with SSC-EWI-0116.

Vertica-specific constraint options (ENABLED, DISABLED) are handled as follows:

• ENABLED is converted to Snowflake’s ENABLE

• DISABLED on CHECK constraints is removed with an FDM annotation

CREATE TABLE products (
    product_id INT PRIMARY KEY,
    quantity INT CHECK (quantity >= 0),
    price DECIMAL(10,2),
    CONSTRAINT chk_price CHECK (price > 0)
);

CREATE OR REPLACE TABLE products (
    product_id INT PRIMARY KEY,
    quantity INT CHECK (quantity >= 0),
    price DECIMAL(10, 2),
    CONSTRAINT chk_price CHECK (price > 0)
)
;

CREATE TABLE orders (
    order_id INT CHECK (order_id > 0) ENABLED,
    status VARCHAR(20) CHECK (status IN ('pending', 'shipped')) DISABLED
);

CREATE OR REPLACE TABLE orders (
    order_id INT CHECK (order_id > 0) ENABLE,
    status VARCHAR(20) /*** SSC-FDM-VT0002 - DISABLED CONSTRAINT OPTION REMOVED. CONSTRAINT WILL BE ENFORCED IN SNOWFLAKE. ***/
)
;

CREATE TABLE invoices (
    invoice_id INT PRIMARY KEY,
    total DECIMAL(10,2) CHECK (validate_amount(total) = true)
);

CREATE OR REPLACE TABLE invoices (
    invoice_id INT PRIMARY KEY,
    total DECIMAL(10, 2)
                         !!!RESOLVE EWI!!! /*** SSC-EWI-0116 - CHECK CONSTRAINT WITH user-defined function IS NOT SUPPORTED IN SNOWFLAKE ***/!!!
                         CHECK (validate_amount(total) = true)
)
;

Uma restrição DEFAULT¶

A cláusula básica DEFAULT do Vertica é totalmente suportada e é traduzida diretamente para o Snowflake. No entanto, para a cláusula DEFAULT USING do Vertica, a tradução é parcial. O Snowflake aplicará corretamente o valor DEFAULT quando novas linhas forem inseridas, mas o recurso de atualização diferido da porção USING não tem equivalente direto e algumas expressões podem não ser suportadas no Snowflake. Portanto, um aviso é adicionado para destacar essa diferença funcional.

CREATE TABLE table1 (
    base_value INT,
    status_code INT DEFAULT 0,
    derived_value INT DEFAULT USING (base_value + 100)
);

CREATE TABLE table1 (
    base_value INT,
    status_code INT DEFAULT 0,
    derived_value INT DEFAULT (base_value + 100) /*** SSC-FDM-VT0001 - EXPRESSION IN USING CONSTRAINT MIGHT NOT BE SUPPORTED IN SNOWFLAKE ***/
)
COMMENT = '{ "origin": "sf_sc", "name": "snowconvert", "version": {  "major": 0,  "minor": 0,  "patch": "0" }, "attributes": {  "component": "vertica",  "convertedOn": "06/17/2025",  "domain": "no-domain-provided" }}';

PRIMARY KEY - UNIQUE - FOREIGN KEY¶

O SnowConvert AI mantém as definições de restrição; entretanto, no Snowflake, essas propriedades são fornecidas para facilitar a migração de outros bancos de dados. Elas não são impostas ou mantidas pelo Snowflake. Isso significa que os padrões podem ser alterados para essas propriedades, mas se os padrões forem alterados, o Snowflake não criará a restrição.

CREATE OR REPLACE TABLE employees (
    emp_id INTEGER,
    first_name VARCHAR(50),
    last_name VARCHAR(50),
    CONSTRAINT pk_employees_enabled PRIMARY KEY (emp_id) ENABLED
);

CREATE OR REPLACE TABLE employees (
    emp_id INTEGER,
    first_name VARCHAR(50),
    last_name VARCHAR(50),
    CONSTRAINT pk_employees_enabled PRIMARY KEY (emp_id) ENABLE
)
COMMENT = '{ "origin": "sf_sc", "name": "snowconvert", "version": {  "major": 0,  "minor": 0,  "patch": "0" }, "attributes": {  "component": "vertica",  "convertedOn": "06/17/2025",  "domain": "no-domain-provided" }}';

Descrição¶

Cria e carrega uma tabela com os resultados de uma consulta. (Referência de linguagem do Vertica SQL “Create Table”).

[ /*+ LABEL */ ]
[ AT epoch ]
[ ENCODED BY column-ref-list ]
[ ENCODING encoding-type ]
[ ACCESSRANK integer ]
[ GROUPED ( column-reference[,...] ) ]

Sintaxe da gramática¶

CREATE TABLE [ IF NOT EXISTS ] [[database.]schema.]table
[ ( column-name-list ) ]
[ {INCLUDE | EXCLUDE} [SCHEMA] PRIVILEGES ]
AS  [ /*+ LABEL */ ] [ AT epoch ] query [ ENCODED BY column-ref-list ] [ segmentation-spec ]

<column-name-list> ::=
column-name-list
    [ ENCODING encoding-type ]
    [ ACCESSRANK integer ]
    [ GROUPED ( column-reference[,...] ) ]

Opções de tabela¶

EWIs relacionados¶

1. SSC-EWI-VT0001: A cláusula de privilégios herdados não é suportada no Snowflake.

Descrição¶

Cria a tabela replicando uma tabela existente. (Referência de linguagem do Vertica SQL “Create Table”).

DISK_QUOTA quota

Sintaxe da gramática¶

CREATE TABLE [ IF NOT EXISTS ] [[database.]schema.]table
  LIKE [[database.]schema.]existing-table
  [ {INCLUDING | EXCLUDING} PROJECTIONS ]
  [ {INCLUDE | EXCLUDE} [SCHEMA] PRIVILEGES ]
  [ DISK_QUOTA quota ]

Opções de tabela¶

EWIs relacionados¶

1. SSC-EWI-VT0001: A cláusula de privilégios herdados não é suportada no Snowflake.