Konvertera SQL med den agentiska kodkonverteraren

Important

Den här funktionen finns i Beta. Om du vill använda den måste en arbetsyteadministratör aktivera agentisk kodkonverterare från sidan Förhandsgranskningar . Se Hantera förhandsversioner av Azure Databricks.

Den agentiska kodkonverteraren använder Genie Code för att konvertera befintlig SQL från dialekter som T-SQL, Snowflake, Redshift, Oracle, BigQuery och Teradata till ANSI SQL som körs på Azure Databricks. Du organiserar ditt arbete i ett migreringsprojekt, där konverteraren analyserar varje källskript, validerar de konverterade utdata och iterativt åtgärdar fel innan du skriver resultatet till en arbetsytemapp.

Den agentiska kodkonverteraren är en del av Databricks-verktyget för att migrera arbetsbelastningar från befintliga informationslager och ETL-verktyg till Azure Databricks. Den konverterar din käll-SQL medan du organiserar och spårar arbetet i ett migreringsprojekt.

Så här fungerar det

Du startar en konvertering genom att skapa ett migreringsprojekt på din arbetsyta. Projektet spårar tillståndet för varje fil och ger dig en enda plats för att hantera migreringen.

När du kör en konvertering anropar Genie Code migreringsfärdigheten och distribuerar underagenter som konverterar filer samtidigt. Varje underagent analyserar källdialekten, genererar ANSI SQL-motsvarigheten, validerar resultatet och försöker igen avsnitt som misslyckas. Konverterade filer skrivs direkt till arbetsytans mapp som du anger för projektet.

Du kan också konvertera en enskild fil eller mapp utan projekt med hjälp /migrate av kommandot i en Genie Code-konversation.

Requirements

• En arbetsyta aktiverad för den agentiska kodkonverteraren Beta. En arbetsyteadministratör aktiverar funktionen från sidan Förhandsversioner . Se Hantera förhandsversioner av Azure Databricks.
• Dina befintliga SQL-filer måste vara tillgängliga på din arbetsyta, antingen uppladdade som arbetsytefiler eller öppna i redigeraren.
• Din arbetsyta måste uppfylla kraven för Genie Code. Se Genie Code.

Källor och begränsningar som stöds

Konverteraren stöder följande källdialekter:

• T-SQL
• Snowflake SQL
• Redshift SQL
• Oracle
• BigQuery
• Teradata

Konverteraren riktar in sig på ANSI SQL. Följande begränsningar gäller för varje konvertering:

• En batch kan innehålla högst 300 filer.
• Ett skript kan innehålla högst 1 000 rader.
• Teradata BTEQ-skript stöds ännu inte.

Konvertera befintlig SQL-kod

Följande steg beskriver hur du konverterar befintlig SQL i ett migreringsprojekt.

Steg 1: Ladda upp källfiler

Ladda upp dina befintliga SQL-filer (.sql) med hjälp av arbetsytans filwebbläsare eller använd Databricks CLI för att massuppladda en katalog med skript.

Steg 2: Skapa ett migreringsprojekt

Skapa ett migreringsprojekt från din arbetsyta:

1. Klicka på >Migreringsprojekt.
2. Ange ett namn för projektet.
3. Använd listrutorna för att välja en källdialekt och ett Målramverk.
4. Ange filsökvägen till målmappen. Klicka på Bläddra för att välja en målplats från en lista över tillgängliga arbetsytemappar.
5. (Valfritt) Ange sökvägen till en ursprungsfil som beskriver projektets ursprung. Klicka på Bläddra för att välja filen från en lista över filer på din arbetsyta.
6. Klicka på Skapa.

Steg 3: Lägga till filer i projektet

I det nya projektet:

1. Klicka på Lägg till filer>+ Lägg till filer.
2. Välj källmappen eller en fil från arbetsytan.

Projektet visar varje fil med filtyp, radantal och konverteringsstatus.

Steg 4: Granska kodkomplexitet och ursprung (valfritt)

Om du har kört Lakebridge Analyzer laddar du upp dess JSON-utdata till projektet för att granska kodkomplexitet och ursprung. Klicka på en källfil för att öppna en komplexitetsbedömning och klicka på Ursprung för att öppna ett beroendediagram som visar beroende filer och tabeller som du måste migrera tillsammans. Anvisningar om hur du kör Analyzer finns i Lakebridge Analyzer-guiden.

Steg 5: Kör konverteringen

Välj de filer som ska konverteras och klicka på Kör. Genie Code öppnar en konversation, anropar migreringsfärdigheten och distribuerar underagenter för att konvertera filerna samtidigt. Varje konverterad fil visas som en länkad fil i projektet. Konverteraren markerar varje fil med status:

• Grön: Konverterades utan problem
• Gul: Behöver granskas
• Röd: Konverteringen misslyckades
• Grå: Pågår

Steg 6: Granska konverteringsresultat

Klicka på en konverterad fil för att öppna ett diff sida vid sida i SQL-redigeraren med källkoden bredvid den föreslagna Databricks SQL. Acceptera alla föreslagna ändringar eller granska och acceptera enskilda redigeringar. För skript som inte kan konverteras redigerar du koden i redigeraren eller ber Genie Code att validera eller försöka igen med specifika avsnitt. När du är nöjd kör du den konverterade SQL-filen i en notebook-fil eller SQL-redigeraren för att bekräfta att den körs på Azure Databricks.

Skapa en anpassad färdighet (valfritt)

Med anpassade kunskaper kan du koda affärsregler som Genie Code tillämpar automatiskt under varje konvertering. Använd dem för att hantera proprietära datatyper, framtvinga önskade målmönster eller samla in korrigeringar som du gör upprepade gånger. En migreringsfärdighet är en Genie Code-färdighet, så du kan skapa och hantera den på samma sätt som andra kunskaper. Mer information finns i Utöka Genie Code med agentkunskaper.

Du kan skapa en färdighet från inställningarna för Genie Code eller från en Genie Code-konversation. Använd inställningssökvägen för komplexa kunskaper som innehåller detaljerade instruktioner, exempel eller stödfiler. Använd chattvägen för snabba färdigheter med en enda regel.

Inställningar för Genie Code

Skapa färdigheten som en fil så att du kan skapa detaljerade instruktioner och version av den i en Git-mapp:

1. I panelen Genie Code klickar du på Inställningar och klicka sedan på Öppna kompetensmappen.

2. Skapa en mapp för din färdighet under arbetsytans sökväg för färdigheter, Workspace/.assistant/skills/. Till exempel Workspace/.assistant/skills/sql-migration/.

3. I skill-mappen skapar du en SKILL.md-fil med den obligatoriska frontmatter-sektionen och dina konverteringsregler. Ett exempel:

   ---
   name: sql-migration
   description: Conversion rules to apply when migrating legacy SQL to ANSI SQL.
   ---
   
   Always convert the custom type MYDATE to TIMESTAMP_NTZ.
   

Genie Code tar till sig färdigheten nästa gång du kör en konvertering.

Genie Code-chatt

Beskriv konverteringsregeln som du vill koda och be sedan Genie Code att spara den:

Tip

Always convert our custom type MYDATE to TIMESTAMP_NTZ. Save this as a custom migration skill.

Genie Code skapar och registrerar färdigheten och tillämpar den på framtida konverteringar på arbetsytan.

Så här visar du aktiva färdigheter:

Tip

Show me my migration skills

Så här tar du bort en färdighet:

Tip

Delete the migration skill for [description]

Arbetsytekunskaper lagras på arbetsytans nivå och delas mellan alla användare på arbetsytan.

Tips för testning

Som en del av sin agentiska loop analyserar konverteraren varje källskript, verifierar att de konverterade utdata är syntaktiskt giltiga och semantiskt likvärdiga med källan, och iterativt åtgärdar avsnitt som misslyckas innan resultatet skrivs. Följande tips hjälper dig att granska och få förtroende för utdata:

• Batchkonvertering: Konvertera en liten batch med två till fem filer i en session för att kontrollera att konverteringen av flera filer fungerar från slutpunkt till slutpunkt.
• Syntaxverifiering: Efter konverteringen kör du utdata i en Databricks SQL-redigerare eller notebook-fil för att bekräfta att den körs utan fel.
• Edge-fall: Inkludera ett skript med dialektspecifika konstruktioner, till exempel T-SQL-fönsterfunktioner, Snowflake QUALIFYeller Redshift LISTAGGför att se hur konverteraren hanterar icke-triviala mönster.
• Semantisk korrekthet: Kör de ursprungliga och konverterade frågorna mot motsvarande testdata och jämför resultaten. Bekräfta att utdata är semantiskt korrekta, inte bara syntaktiskt giltiga.

Ytterligare resurser

• Genie Code
• Lakebridge-dokumentation