SnowConvert AI – Einstellungen für die Vorschau-Features¶

Erläuterungen zu den Vorschau-Features von Snowflake¶

Bei den öffentlichen Vorschau-Features von Snowflake handelt es sich um neue Funktionen, die in Snowflake implementiert und getestet wurden, jedoch möglicherweise noch nicht vollständig nutzbar sind oder noch nicht alle Sonderfälle abdecken. Wenn Sie die Vorschau-Features in SnowConvert AI aktivieren, kann der Konvertierungsprozess Code erzeugen, der diese Vorschau-Features verwendet, wenn sie bessere Konvertierungsergebnisse liefern.

Verwenden der Vorschau-Features¶

1. In SnowConvert AI aktivieren: Geben Sie eines der [verfügbaren Flags](# available-preview-features) in das Textfeld in den Einstellungen für die Vorschau-Features ein, um es SnowConvert AI zu erlauben, Code mit Snowflake-Vorschau-Features zu generieren.

2. In Snowflake aktivieren: Stellen Sie sicher, dass die Vorschau-Features in Ihrem Snowflake-Konto aktiviert sind, indem Sie Systemfunktionen wie SYSTEM_ENABLE_PREVIEW_ACCESS verwenden.

3. ** Gründlich testen**: Testen Sie den konvertierten Code immer in einer nicht produktiven Snowflake-Umgebung, wenn Sie Vorschau-Features verwenden.

Wichtige Hinweise¶

• Snowflake-Konto-Kompatibilität: Für Ihr Snowflake-Konto müssen Vorschau-Features aktiviert sein, um den generierten Code verwenden zu können.

• Feature-Stabilität: Die Vorschau-Features von Snowflake können in zukünftigen Snowflake-Releases das Verhalten ändern oder entfernt werden.

• Beschränkung auf Produktionsumgebungen: Code, der Vorschau-Features verwendet, sollte nicht in Snowflake-Produktionsumgebungen bereitgestellt werden.

• Dokumentation: SnowConvert AI kann Kommentare hinzufügen, die angeben, wann Vorschau-Features verwendet werden.

Zugriff auf die Einstellungen für die Vorschau-Features¶

So konfigurieren Sie die Vorschau-Features in SnowConvert AI:

1. Navigieren Sie auf der Oberfläche von SnowConvert AI zum Abschnitt Conversion Settings.

2. Wählen Sie die Registerkarte oder den Abschnitt Preview Features aus.

3. Geben Sie eines der [verfügbaren Flags](# available-preview-features) in das Textfeld ein, um SnowConvert AI die Verwendung von Snowflake-Vorschau-Features zu erlauben. Achten Sie darauf, dass jedes Flag korrekt geschrieben ist. Wenn ein Flag falsch geschrieben ist, werden alle Flags bei der Konvertierung ignoriert.

4. Fahren Sie mit der Konvertierung fort. SnowConvert AI verwendet Vorschau-Features automatisch, wenn sie die Konvertierungsergebnisse verbessern.

Verwenden von Vorschau-Features von der CLI¶

Bei Verwendung von SnowConvert AI über die Befehlszeilenschnittstelle (CLI) können Sie die Vorschau-Features über das --previewFlags-Argument aktivieren. Der Wert muss in Anführungszeichen stehen und die Flags im folgenden Format enthalten:

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

Beispiel:

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

Bei mehreren Flags:

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

Best Practices¶

• Kenntnis der Auswirkungen: Bitte beachten Sie, dass für den konvertierten Code die Snowflake-Vorschau-Features aktiviert sein müssen.

--enableSnowScriptUDF¶

Veraltet seit Version 1.19.7. Dieses Feature ist bereits allgemein verfügbar.

Diese Option ermöglicht es SnowConvert AI, benutzerdefinierte Funktionen zu übersetzen und so die Vorteile des SnowScript-UDF-Vorschau-Features zu nutzen. Weitere Informationen erhalten Sie in dieser Dokumentation: Snowflake Scripting UDFs.

Nur für die folgenden Sprachen verfügbar:

• 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