SQL converteren met het conversieprogramma voor agentische code

Belangrijk

Deze functie bevindt zich in de bètaversie. Als u deze wilt gebruiken, moet een werkruimtebeheerder het conversieprogramma voor agentische code inschakelen vanaf de pagina Previews . Zie Azure Databricks previews beheren.

Het conversieprogramma voor agentische code maakt gebruik van Genie Code om bestaande SQL te converteren van dialecten zoals T-SQL, Snowflake, Redshift, Oracle, BigQuery en Teradata naar ANSI SQL die wordt uitgevoerd op Azure Databricks. U ordent uw werk in een migratieproject, waarbij het conversieprogramma elk bronscript analyseert, de geconverteerde uitvoer valideert en iteratief fouten oplost voordat de resultaten naar een werkruimtemap worden geschreven.

Het conversieprogramma voor agentische code maakt deel uit van de Databricks-hulpprogramma's voor het migreren van workloads van bestaande datawarehouses en ETL-hulpprogramma's naar Azure Databricks. Uw bron-SQL wordt geconverteerd terwijl u het werk in een migratieproject ordent en bijhoudt.

Hoe werkt het?

U start een conversie door een migratieproject in uw werkruimte te maken. Het project houdt de status van elk bestand bij en geeft u één plek om de migratie te beheren.

Wanneer u een conversie uitvoert, roept Genie Code de migratievaardigheid aan en implementeert subagents waarmee bestanden gelijktijdig worden geconverteerd. Elke subagent analyseert het brondialect, genereert het ANSI SQL-equivalent, valideert het resultaat en probeert secties opnieuw uit te voeren die mislukken. Geconverteerde bestanden worden rechtstreeks naar de werkruimtemap geschreven die u voor het project opgeeft.

U kunt ook één bestand of map zonder project converteren met behulp van de /migrate opdracht in een Genie Code-gesprek.

Requirements

• Een werkruimte die is ingeschakeld voor de bètaversie van het agentische codeconversieprogramma. Een werkruimtebeheerder schakelt de functie in vanaf de pagina Voorbeeldweergaven . Zie Azure Databricks previews beheren.
• Uw bestaande SQL-bestanden moeten toegankelijk zijn in uw werkruimte, geüpload als werkruimtebestanden of zijn geopend in de editor.
• Uw werkruimte moet voldoen aan de geniecodevereisten. Zie Genie Code.

Ondersteunde bronnen en beperkingen

Het conversieprogramma ondersteunt de volgende brondialecten:

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

Het conversieprogramma is gericht op ANSI SQL. De volgende limieten zijn van toepassing op elke conversie:

• Een batch kan maximaal 300 bestanden bevatten.
• Een script kan maximaal 1000 regels bevatten.
• Teradata BTEQ-scripts worden nog niet ondersteund.

Bestaande SQL-code converteren

In de volgende stappen wordt beschreven hoe u bestaande SQL in een migratieproject converteert.

Stap 1: Bronbestanden uploaden

Upload uw bestaande SQL-bestanden (.sql) met behulp van de browser voor het werkruimtebestand of gebruik de Databricks CLI om bulksgewijs een map met scripts te uploaden.

Stap 2: Een migratieproject maken

Maak een migratieproject vanuit uw werkruimte:

1. Klik op >Migratieproject.
2. Voer een naam in voor het project.
3. Gebruik de vervolgkeuzelijsten om een brondialect en een doelframework te kiezen.
4. Voer het pad van de doelmap in. Klik op Bladeren om een bestemming te kiezen in een lijst met beschikbare werkruimtemappen.
5. (Optioneel) Voer het pad in naar een herkomstbestand waarin de herkomst van het project wordt beschreven. Klik op Bladeren om het bestand te kiezen in een lijst met bestanden in uw werkruimte.
6. Klik op Create.

Stap 3: Bestanden toevoegen aan uw project

In het nieuwe project:

1. Klik op Bestanden> toevoegen+ Bestanden toevoegen.
2. Selecteer de bronmap of een bestand in uw werkruimte.

Het project bevat elk bestand met het bestandstype, het aantal regels en de conversiestatus.

Stap 4: Codecomplexiteit en herkomst controleren (optioneel)

Als u Lakebridge Analyzer hebt uitgevoerd, uploadt u de JSON-uitvoer naar het project om de complexiteit en herkomst van de code te controleren. Klik op een bronbestand om een complexiteitsbeoordeling te openen en klik op Lineage om een afhankelijkheidsgrafiek te openen die onderling afhankelijke bestanden en tabellen weergeeft die u samen moet migreren. Zie de Lakebridge Analyzer-handleiding voor instructies over het uitvoeren van de Analyzer.

Stap 5: De conversie uitvoeren

Selecteer de bestanden die u wilt converteren en klik op Uitvoeren. Genie Code opent een gesprek, roept de migratievaardigheid aan en implementeert subagents om de bestanden gelijktijdig te converteren. Elk geconverteerd bestand wordt weergegeven als een gekoppeld bestand in het project. Het conversieprogramma markeert elk bestand met een status:

• Groen: succesvol geconverteerd
• Geel: Revisie van behoeften
• Rood: Conversie is mislukt
• Grijs: Wordt uitgevoerd

Stap 6: Conversieresultaten bekijken

Klik op een geconverteerd bestand om een diff naast elkaar te openen in de SQL-editor, met de broncode naast de voorgestelde Databricks SQL. Accepteer alle voorgestelde wijzigingen of controleer en accepteer afzonderlijke bewerkingen. Voor scripts die niet kunnen worden geconverteerd, bewerkt u de code in de editor of vraagt u Genie Code om specifieke secties opnieuw te valideren of opnieuw uit te voeren. Nadat u tevreden bent, voert u de geconverteerde SQL uit in een notebook of de SQL-editor om te bevestigen dat deze wordt uitgevoerd op Azure Databricks.

Een aangepaste vaardigheid maken (optioneel)

Met aangepaste vaardigheden kunt u bedrijfsregels coderen die Genie Code automatisch toepast tijdens elke conversie. Gebruik deze om bedrijfseigen gegevenstypen af te handelen, voorkeursdoelpatronen af te dwingen of correcties vast te leggen die u herhaaldelijk maakt. Een migratievaardigheid is een Genie Code-vaardigheid, zodat u deze op dezelfde manier kunt maken en beheren als elke andere vaardigheid. Zie Genie Code uitbreiden met agentvaardigheden voor meer informatie.

U kunt een vaardigheid maken vanuit de Genie Code-instellingen of vanuit een Genie Code-gesprek. Gebruik het pad naar instellingen voor complexe vaardigheden met gedetailleerde instructies, voorbeelden of ondersteunende bestanden. Gebruik het chatpad voor snelle vaardigheden met één regel.

Genie Code-instellingen

Maak de vaardigheid als een bestand, zodat u gedetailleerde instructies en versie ervan kunt maken in een Git-map:

1. Klik in het paneel Genie Code op Instellingen en klik vervolgens op Open de map vaardigheden.

2. Maak een map voor uw vaardigheid onder het pad naar werkruimtevaardigheden. Workspace/.assistant/skills/ Bijvoorbeeld: Workspace/.assistant/skills/sql-migration/.

3. Maak in de vaardigheidsmap een SKILL.md-bestand met de vereiste kopgegevens en je conversieregels. Voorbeeld:

   ---
   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 haalt de vaardigheid op wanneer u de volgende keer een conversie uitvoert.

Genie Code chat

Beschrijf de conversieregel die u wilt coderen en vraag Genie Code om deze op te slaan:

Tip

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

Genie Code maakt en registreert de vaardigheid en past deze toe bij toekomstige omzettingen in de werkruimte.

Actieve vaardigheden weergeven:

Tip

Show me my migration skills

Een vaardigheid verwijderen:

Tip

Delete the migration skill for [description]

Werkruimtevaardigheden worden op werkruimteniveau opgeslagen en gedeeld door alle gebruikers in de werkruimte.

Tips voor testen

Als onderdeel van de agentische lus analyseert het conversieprogramma elk bronscript, valideert het dat de geconverteerde uitvoer syntactisch geldig en semantisch gelijk is aan de bron en corrigeert iteratief secties die mislukken voordat de resultaten worden geschreven. Met de volgende tips kunt u de uitvoer controleren en er vertrouwen in krijgen:

• Batchconversie: converteer een kleine batch van twee naar vijf bestanden in één sessie om te controleren of conversie met meerdere bestanden end-to-end werkt.
• Syntaxisvalidatie: Voer na conversie de uitvoer uit in een Databricks SQL-editor of notebook om te bevestigen dat deze zonder fouten wordt uitgevoerd.
• Edge-gevallen: Neem een script op met dialectspecifieke constructies, zoals T-SQL-vensterfuncties, Snowflake QUALIFYof Redshift LISTAGG, om te zien hoe het conversieprogramma niet-triviale patronen verwerkt.
• Semantische juistheid: voer de oorspronkelijke en geconverteerde query's uit op gelijkwaardige testgegevens en vergelijk de resultaten. Controleer of de uitvoer semantisch juist is, niet alleen syntactisch geldig.

Aanvullende bronnen

• Genie Code
• Documentatie voor Lakebridge