SnowConvert AI - Configurações de recursos em versão preliminar

Configurações de recursos em versão preliminar

As configurações de recursos em versão preliminar no SnowConvert AI permitem que você habilite conversões que utilizam recursos em versão preliminar pública do Snowflake. Ao inserir qualquer um dos sinalizadores disponíveis na caixa de texto, o SnowConvert AI pode gerar código que aproveita os recursos do Snowflake que estão atualmente em status de versão preliminar pública, em vez de se limitar apenas aos recursos do Snowflake que estão geralmente disponíveis (GA).

imagem

Aviso

Os recursos em versão preliminar são recursos do Snowflake que estão disponíveis para fins de avaliação e teste, mas ainda não estão disponíveis de forma geral (GA). Eles não devem ser usados em sistemas de produção. Para obter mais detalhes sobre os recursos em versão preliminar do Snowflake, consulte os Termos de serviço da versão preliminar do Snowflake.

Explicação dos recursos em versão preliminar do Snowflake

Os recursos em versão preliminar pública do Snowflake são novas funcionalidades que foram implementadas e testadas no Snowflake, mas que podem não ter usabilidade completa ou tratamento de casos extremos. Quando você ativa recursos em versão preliminar no SnowConvert AI, o processo de conversão pode gerar um código que usa esses recursos em versão preliminar quando eles fornecem melhores resultados de conversão.

Como usar os recursos em versão preliminar

  1. Habilitar no SnowConvert AI: Insira qualquer um dos [sinalizadores disponíveis](# availability-preview-features) na caixa de texto nas configurações de recursos em versão preliminar para permitir que oSnowConvert AI gere código usando os recursos em versão preliminar do Snowflake

  2. Habilitar no Snowflake: Certifique-se de que os recursos em versão preliminar estejam habilitados em sua conta Snowflake usando funções do sistema como SYSTEM_ENABLE_PREVIEW_ACCESS

  3. Teste minuciosamente: Sempre teste o código convertido em um ambiente Snowflake que não seja de produção ao usar recursos em versão preliminar

Considerações importantes

  • Compatibilidade da conta Snowflake: Sua conta Snowflake deve ter recursos em versão preliminar habilitados para usar o código gerado

  • Estabilidade do recurso: Os recursos em versão preliminar do Snowflake podem mudar de comportamento ou serem removidos em versões futuras do Snowflake

  • Restrições de produção: O código que usa recursos em versão preliminar não deve ser implantado em ambientes Snowflake de produção

  • Documentação: o SnowConvert AI pode adicionar comentários indicando quando os recursos em versão preliminar estão sendo usados

Acesso às configurações dos recursos em versão preliminar

Para configurar os recursos em versão preliminar no SnowConvert AI:

  1. Navegue até a seção Configurações de conversão na interface do SnowConvert AI

  2. Selecione a guia ou a seção Recursos em versão preliminar

  3. Insira qualquer um dos sinalizadores disponíveis na caixa de texto para permitir que oSnowConvert AI use os recursos em versão preliminar do Snowflake. Certifique-se de que cada sinalizador seja digitado corretamente; se algum sinalizador estiver incorreto, todos os sinalizadores serão ignorados durante a conversão.

  4. Prosseguir com conversão - oSnowConvert AI usará automaticamente os recursos em versão preliminar quando eles melhorarem os resultados de conversão.

Uso dos recursos em versão preliminar do CLI

Ao usar o SnowConvert AI na interface de linha de comando (CLI), é possível ativar os recursos em versão preliminar usando o argumento --previewFlags. O valor deve estar entre aspas e conter os sinalizadores no seguinte formato:

--previewFlags "\"--enableFlag1 --enableFlag2\""

Exemplo:

snowct [command] --previewFlags "\"--enableFlag\"" [other arguments]

Para vários sinalizadores:

snowct [command] --previewFlags "\"--enableFlag --enableAnotherFlag\"" [other arguments]

Práticas recomendadas

  • Entender as implicações: Certifique-se de entender que o código convertido exigirá que os recursos em versão preliminar do Snowflake estejam ativados

Nota

Para obter as informações mais atualizadas sobre quais recursos em versão preliminar do Snowflake oSnowConvert AI pode utilizar, consulte as notas de versão mais recentes do SnowConvert AI ou entre em contato com o suporte.

Recursos em versão preliminar disponíveis

A seção seguinte lista os sinalizadores de recursos em versão preliminar que podem ser inseridos na caixa de texto para ativar recursos específicos do Snowflake em versão preliminar durante a conversão. Cada sinalizador permite que oSnowConvert AI use recursos específicos em versão preliminar do Snowflake.

--enableSnowScriptUDF

Obsoleto desde a versão 1.19.7. Este recurso já está em Disponibilidade geral

Esta opção permite que o SnowConvert AI converta funções definidas pelo usuário, aproveitando o recurso em versão preliminar doSnowScript UDF. Saiba mais na documentação aqui: Snowflake Scripting UDFs.

Disponível apenas para os seguintes idiomas:

  • Sql Server.

  • Azure Sinapse.

--enableFormatSpecifiersPreview

This option enables SnowConvert AI to utilize new Snowflake date/time format specifiers that are currently in preview. These improvements in Snowflake’s formatting capabilities provide better translation accuracy for SQL Server date/time formatting functions.

Nota

Numeric format specifiers are now GA. Advanced numeric format specifiers (P, N, custom % patterns, and TM9 grouping) are now translated by default without requiring this flag. The translations in the Numeric format specifiers (now default) section below are always active.

What This Flag Enables:

This preview feature introduces new date/time format elements in Snowflake’s TO_CHAR function, allowing SnowConvert AI to generate more accurate translations of SQL Server FORMAT() calls:

  1. New Date/Time Format Elements - Non-padded format specifiers (Y, MO, D, H24, H12, ME, S, P)

These are Snowflake improvements, not just SnowConvert AI translation features. Your Snowflake account must have these preview features enabled to execute the converted date/time code.

Note: To use date/time code generated with this flag, you must request access to these preview features in your Snowflake account. Submit your request using this form: Snowflake Format Improvements Preview Access Request

Date Format Specifiers (Preview)

This flag enables SnowConvert AI to use new Snowflake date/time format elements that support non-padded output, providing accurate translations of SQL Server’s custom single-character format specifiers.

New Snowflake Format Elements:

These format elements are new in Snowflake (in preview) and enable better migration from SQL Server:

  • Y - Year last 2 digits without padding (e.g., 25 from 2025, 5 from 2005)

  • MO - Month without padding (e.g., 3 for March)

  • D - Day without padding (e.g., 5 for the 5th day)

  • H24 - Hour in 24-hour format without padding (e.g., 14 for 2 PM)

  • H12 - Hour in 12-hour format without padding (e.g., 2 for 2 PM)

  • ME - Minute without padding (e.g., 7 for 07 minutes)

  • S - Second without padding (e.g., 3 for 03 seconds)

  • P - Single-character AM/PM indicator (e.g., A for AM, P for PM)

Translation Examples:

The following examples show how SQL Server FORMAT() patterns are translated to Snowflake using these new format elements:

SQL Server Code

SQL Server Output

Snowflake Translation

Snowflake Output

FORMAT(CAST('2025-03-05' AS DATE), '%M')

3

TO_CHAR(TO_TIMESTAMP_NTZ('2025-03-05'), 'MO')

3

FORMAT(CAST('2025-03-05' AS DATE), '%d')

5

TO_CHAR(TO_TIMESTAMP_NTZ('2025-03-05'), 'D')

5

FORMAT(CAST('2025-03-05' AS DATE), '%y')

25

TO_CHAR(TO_TIMESTAMP_NTZ('2025-03-05'), 'Y')

25

FORMAT(CAST('2025-03-05 14:07:03' AS DATETIME), '%H')

14

TO_CHAR(TO_TIMESTAMP_NTZ('2025-03-05 14:07:03'), 'H24')

14

FORMAT(CAST('2025-03-05 14:07:03' AS DATETIME), '%h')

2

TO_CHAR(TO_TIMESTAMP_NTZ('2025-03-05 14:07:03'), 'H12')

2

FORMAT(CAST('2025-03-05 14:07:03' AS DATETIME), '%m')

7

TO_CHAR(TO_TIMESTAMP_NTZ('2025-03-05 14:07:03'), 'ME')

7

FORMAT(CAST('2025-03-05 14:07:03' AS DATETIME), '%s')

3

TO_CHAR(TO_TIMESTAMP_NTZ('2025-03-05 14:07:03'), 'S')

3

Combined Format Patterns:

SQL Server Code

SQL Server Output

Snowflake Translation

Snowflake Output

FORMAT(CAST('2025-03-05 14:07:03' AS DATETIME), 'M/d/yyyy H:m:s')

3/5/2025 14:7:3

TO_CHAR(TO_TIMESTAMP_NTZ('2025-03-05 14:07:03'), 'MO/D/YYYY H24:ME:S')

3/5/2025 14:7:3

FORMAT(CAST('2025-03-05 14:07:03' AS DATETIME), 'M/d/yyyy h:m:s tt')

3/5/2025 2:7:3 PM

TO_CHAR(TO_TIMESTAMP_NTZ('2025-03-05 14:07:03'), 'MO/D/YYYY H12:ME:S PM')

3/5/2025 2:7:3 PM

FORMAT(CAST('2025-03-05 14:07:03' AS DATETIME), 'h:m:s t')

2:7:3 P

TO_CHAR(TO_TIMESTAMP_NTZ('2025-03-05 14:07:03'), 'H12:ME:S P')

2:7:3 P

FORMAT(CAST('2025-03-05' AS DATE), 'M/d/%y')

3/5/25

TO_CHAR(TO_TIMESTAMP_NTZ('2025-03-05'), 'MO/D/Y')

3/5/25

Key Points:

  • MO replaces SQL Server’s %M (uppercase M = month)

  • ME replaces SQL Server’s %m (lowercase m = minute)

  • H24 replaces SQL Server’s %H (uppercase H = 24-hour)

  • H12 replaces SQL Server’s %H (lowercase h = 12-hour)

  • P provides single-character AM/PM output (A or P)

  • All formats maintain SQL Server’s behavior of no leading zeros

Numeric format specifiers (now default)

The following numeric format translations are now applied by default without requiring the --enableFormatSpecifiersPreview flag. SnowConvert AI translates SQL Server’s percentage and number formatting patterns using Snowflake’s numeric format capabilities.

Percentage Formats (P and %):

SQL Server’s P format and custom % patterns automatically multiply values by 100 and add percentage symbols. The Snowflake translations use fixed-point formats with % symbols:

SQL Server Code

SQL Server Output

Snowflake Translation

Snowflake Output

FORMAT(0.1234, 'P')

12.34 %

TO_CHAR(0.1234, 'FM9,999,999,999,999.00%')

12.34 %

FORMAT(0.1234, 'P0')

12 %

TO_CHAR(0.1234, 'FM9,999,999,999,999%')

12 %

FORMAT(0.1234, 'P2')

12.34 %

TO_CHAR(0.1234, 'FM9,999,999,999,999.00%')

12.34 %

FORMAT(0.1234, '0.00%')

12.34%

TO_CHAR(0.1234, 'FM9999999999999.00%')

12.34%

FORMAT(0.1234, '#,#.00%')

12.34%

TO_CHAR(0.1234, 'FM9,999,999,999,999.00%')

12.34%

FORMAT(0.1234, '%0.00')

%12.34

TO_CHAR(0.1234, '%FM9999999999999.00')

%12.34

Number Formats (N):

SQL Server’s N format provides thousand separators and controlled decimal precision. The Snowflake translations use the enhanced TM9 format element with arguments:

SQL Server Code

SQL Server Output

Snowflake Translation

Snowflake Output

FORMAT(1234567.89, 'N')

1,234,567.89

TO_CHAR(1234567.89, 'TM9(2,3)')

1,234,567.89

FORMAT(1234567.89, 'N0')

1,234,568

TO_CHAR(1234567.89, 'TM9(0,3)')

1,234,568

FORMAT(1234567.89, 'N1')

1,234,567.9

TO_CHAR(1234567.89, 'TM9(1,3)')

1,234,567.9

FORMAT(1234567.89, 'N4')

1,234,567.8900

TO_CHAR(1234567.89, 'TM9(4,3)')

1,234,567.8900

FORMAT(-1234567.89, 'N2')

-1,234,567.89

TO_CHAR(-1234567.89, 'TM9(2,3)')

-1,234,567.89

TM9 Format Element Enhancement (Now Default)

The existing Snowflake TM9 format element has been enhanced to accept two optional arguments for better control over numeric formatting. This is a Snowflake improvement that enables better translations from SQL Server. These translations are now applied by default.

Syntax: TM9(fractional_digits, grouping_size)

Translation Examples:

SQL Server Code

Snowflake Translation

Input Value

Snowflake Output

Description

FORMAT(x, 'N2')

TO_CHAR(x, 'TM9(2,3)')

1234.56789

1,234.57

2 decimals with grouping

FORMAT(x, 'N0')

TO_CHAR(x, 'TM9(0,3)')

1234.56789

1,235

No decimals, rounded

FORMAT(x, 'N4')

TO_CHAR(x, 'TM9(4,3)')

1234567.89

1,234,567.8900

4 decimals with grouping

(Direct usage)

TO_CHAR(x, 'TM9(ALL,3)')

1234.56789

1,234.56789

All decimals, grouped

(Direct usage)

TO_CHAR(x, 'TM9(3)')

1234.56789

1234.568

3 decimals, no grouping

(Direct usage)

TO_CHAR(x, 'TM9')

1234.56789

1234.56789

All decimals, no grouping (default)

Behavior Details:

-- Snowflake examples with TM9 enhancement
SELECT 
    TO_CHAR(1234.56789, 'TM9')           AS default_format,    -- 1234.56789
    TO_CHAR(1234.56789, 'TM9(2)')        AS two_decimals,      -- 1234.57
    TO_CHAR(1234.56789, 'TM9(0)')        AS integer_only,      -- 1235
    TO_CHAR(1234.56789, 'TM9(ALL, 3)')   AS all_with_group,    -- 1,234.56789
    TO_CHAR(1234567.89, 'TM9(3, 3)')     AS three_with_group,  -- 1,234,567.890
    TO_CHAR(-1234567.89, 'TM9(2, 3)')    AS negative_value;    -- -1,234,567.89

Available for: SQL Server only

--UseIntervalDatatype

This option enables SnowConvert AI to translate INTERVAL data types to native Snowflake INTERVAL types (INTERVAL YEAR TO MONTH and INTERVAL DAY TO SECOND) instead of converting them to VARCHAR. This takes advantage of the Snowflake INTERVAL data type that is currently in public preview. Learn more from the documentation here: Snowflake INTERVAL Data Type.

For a comprehensive reference on how interval transformations work across all languages, see the Interval Data Types translation reference.

What This Flag Enables:

  1. Native INTERVAL column types - INTERVAL columns in CREATE TABLE are preserved as Snowflake INTERVAL types instead of being converted to VARCHAR(30)

  2. Interval literal normalization - Dialect-specific interval literal syntax is normalized to Snowflake-compatible INTERVAL literals

  3. Interval arithmetic preservation - Datetime subtraction expressions that produce intervals are transformed to use Snowflake’s native interval output

  4. CAST to INTERVAL - CAST expressions targeting interval types are preserved

Translation Examples:

Source SQL

Without Flag

With --UseIntervalDatatype

col1 INTERVAL DAY TO SECOND (Oracle, Teradata)

col1 VARCHAR(30) + SSC-EWI-0036

col1 INTERVAL DAY TO SECOND

col1 INTERVAL (BigQuery, PostgreSQL)

col1 VARCHAR(30) + SSC-EWI-0036

col1 INTERVAL DAY TO SECOND + SSC-FDM-0042

SELECT INTERVAL '5-10' YEAR TO MONTH

SELECT '5-10' (string literal)

SELECT INTERVAL '5-10' YEAR TO MONTH

SELECT (ts1 - ts2) DAY TO SECOND

Not transformed to interval

SELECT ts1 - ts2 INTERVAL DAY TO SECOND

Known Limitations:

When this flag is enabled, SnowConvert AI emits warnings for scenarios where Snowflake does not yet fully support INTERVAL:

  • Dynamic Tables (SSC-EWI-0118): Snowflake does not support INTERVAL columns in Dynamic Tables

  • UDFs and Snowflake Scripting (SSC-EWI-0117): Snowflake does not support the INTERVAL data type in UDF/procedure parameters, return types, or variable declarations

  • Semi-structured types (SSC-EWI-0116): Snowflake does not support INTERVAL values inside VARIANT, ARRAY, or other semi-structured type columns

  • Qualifier normalization (SSC-FDM-0042): For languages with unqualified or mixed INTERVAL types, the qualifier is changed to DAY TO SECOND because Snowflake does not support mixing year-to-month and day-to-second time parts

Available for: All supported languages (Teradata, Oracle, SQL Server, Azure Synapse, BigQuery, Hive, Spark, Databricks, PostgreSQL, Greenplum, Netezza, Redshift, Vertica, DB2)