SnowConvert AI - 미리 보기 기능 설정¶

Snowflake 미리 보기 기능 이해하기¶

Snowflake 공개 미리 보기 기능은 Snowflake에서 구현 및 테스트된 새로운 기능이지만, 완전한 유용성 또는 특이한 상황에 대한 처리가 없을 수 있습니다. SnowConvert AI에서 미리 보기 기능을 활성화하면 변환 프로세스가 더 나은 변환 결과를 얻게 되는 경우 이러한 미리 보기 기능을 사용하는 코드를 생성할 수 있습니다.

미리 보기 기능을 사용하는 방법¶

1. SnowConvert AI에서 활성화: 미리 보기 기능 설정 내의 텍스트 상자에 사용 가능한 플래그를 입력하여 SnowConvert AI가 Snowflake 미리 보기 기능을 사용해 코드를 생성할 수 있도록 허용합니다.

2. Snowflake에서 활성화: SYSTEM_ENABLE_PREVIEW_ACCESS와 같은 시스템 함수를 사용하여 Snowflake 계정에서 미리 보기 기능이 활성화되어 있는지 확인합니다.

3. 철저한 테스트: 미리 보기 기능을 사용할 때는 항상 비프로덕션 Snowflake 환경에서 변환된 코드를 테스트합니다.

중요 고려 사항¶

• Snowflake 계정 호환성: 생성된 코드를 사용하려면 Snowflake 계정에 미리 보기 기능이 활성화되어 있어야 합니다.

• 기능 안정성: Snowflake 미리 보기 기능은 향후 Snowflake 릴리스에서 동작이 변경되거나 제거될 수 있습니다.

• 프로덕션 제한 사항: 미리 보기 기능을 사용하는 코드는 프로덕션 Snowflake 환경에 배포하면 안 됩니다.

• 설명서: SnowConvert AI는 미리 보기 기능이 사용 중임을 나타내는 주석을 추가할 수 있습니다.

미리 보기 기능 설정에 액세스하기¶

SnowConvert AI에서 미리 보기 기능을 구성하려면 다음을 수행합니다.

1. SnowConvert AI 인터페이스에서 변환 설정 섹션으로 이동합니다.

2. 미리 보기 기능 탭 또는 섹션을 선택합니다.

3. 텍스트 상자에 사용 가능한 플래그를 입력하여 SnowConvert AI가 Snowflake 미리 보기 기능을 사용하도록 허용합니다. 각 플래그의 철자가 올바른지 확인하세요. 플래그의 철자가 틀리면 변환 중에 모든 플래그가 무시됩니다.

4. 변환 진행하기 - SnowConvert AI는 변환 결과가 개선되는 경우 미리 보기 기능을 자동으로 사용합니다.

CLI에서 미리 보기 기능 사용하기¶

명령줄 인터페이스(CLI)에서 SnowConvert AI를 사용하는 경우 --previewFlags 인자를 통해 미리 보기 기능을 활성화할 수 있습니다. 값은 따옴표로 묶어야 하며 다음 형식의 플래그를 포함해야 합니다.

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

예:

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

여러 플래그의 경우:

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

모범 사례¶

• 의미 이해: 변환된 코드를 사용하려면 Snowflake 미리 보기 기능을 활성화해야 한다는 점을 이해해야 합니다.

--enableSnowScriptUDF¶

버전 1.19.7부터 사용 중단됩니다. 이 기능은 이미 일반 공급으로 제공됩니다

이 옵션을 사용하면 SnowConvert AI가 SnowScript UDF 미리 보기 기능을 활용하여 사용자 정의 함수를 변환할 수 있습니다. Snowflake Scripting UDFs 설명서에서 자세히 알아보세요.

다음 언어에만 사용할 수 있습니다.

• Sql Server.

• Azure Synapse.

--enableFormatSpecifiersPreview¶

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

What This Flag Enables:

This preview feature introduces new format elements and enhancements 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)

2. Enhanced Numeric Formatting - Percentage and number formats with proper grouping

3. TM9 Format Enhancement - Arguments for precision and grouping control

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

Note: To use 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:

Combined Format Patterns:

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 (Preview)

This flag enables SnowConvert AI to translate 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:

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:

TM9 Format Element Enhancement (Preview)

The existing Snowflake TM9 format element has been enhanced in this preview to accept two optional arguments for better control over numeric formatting. This is a Snowflake improvement that enables better translations from SQL Server.

Syntax: TM9(fractional_digits, grouping_size)

Translation Examples:

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