SnowConvert AI - Azure Synapse¶
What is SnowConvert AI for Azure Synapse?¶
SnowConvert AI is a software that understands Azure Synapse scripts and converts this source code into functionally equivalent Snowflake code.
Types de conversion¶
Specifically, SnowConvert AI for Azure Synapse performs the following conversions:
Azure Synapse vers Snowflake SQL¶
SnowConvert AI understands the Azure Synapse source code and converts the Data Definition Language (DDL), Data Manipulation Language (DML), and functions in the source code to the corresponding SQL in the target: Snowflake.
Exemple de code¶
Code d’entrée de base d’Azure Synapse :
CREATE TABLE Persons (
PersonID int,
LastName varchar(255),
FirstName varchar(255),
Address varchar(255),
City varchar(255)
);
Code de sortie de Snowflake SQL :
CREATE OR REPLACE TABLE Persons (
PersonID INT,
LastName VARCHAR(255),
FirstName VARCHAR(255),
Address VARCHAR(255),
City VARCHAR(255)
)
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},{"attributes":{"component":"azure synapse"}}'
;
Comme vous pouvez le constater, la majeure partie de la structure reste inchangée. Dans certains cas, les types de données doivent être transformés, par exemple.
Procédures stockées Azure Synapse en procédures JavaScript intégrées dans Snowflake SQL :¶
SnowConvert AI takes Azure Synapse stored procedures and converts them to JavaScript embedded into Snowflake SQL. Azure Synapse’s CREATE PROCEDURE is replaced by Snowflake’s CREATE OR REPLACE PROCEDURE. JavaScript is called as a scripting language, and all of the inner statements are converted to JavaScript.
Exemple de code¶
Procédure stockée de base d’Azure Synapse :
CREATE PROCEDURE SelectAllCustomers
AS
SELECT * FROM Customers
GO;
Code de sortie Snowflake SQL avec JavaScript intégré :
-- Additional Params: -t JavaScript
CREATE OR REPLACE PROCEDURE SelectAllCustomers ()
RETURNS STRING
LANGUAGE JAVASCRIPT
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},"attributes":{"component":"transact"}}'
EXECUTE AS CALLER
AS
$$
// REGION SnowConvert AI Helpers Code
// END REGION
EXEC(`SELECT
*
FROM
Customers`);
$$;
!!!RESOLVE EWI!!! /*** SSC-EWI-0040 - THE STATEMENT IS NOT SUPPORTED IN SNOWFLAKE ***/!!!
;
Lors de la création du code JavaScript, une partie du code est ajoutée en tant qu’assistant nécessaire pour faciliter la transformation du contenu de la procédure.
Vous pouvez vous attendre à voir apparaître des avertissements avec un code associé pour vous aider à comprendre ce qui se passe dans le code converti. (Voir Problèmes et dépannage)
SnowConvert AI Terminology¶
Avant de nous perdre dans la magie de ces conversions de code, voici quelques termes/définitions afin que vous sachiez de quoi nous parlons lorsque nous commençons à les utiliser dans la documentation :
SQL (Structured Query Language) : langage standard pour stocker, manipuler et récupérer des données dans la plupart des architectures de bases de données modernes.
SnowConvert AI: the software that converts securely and automatically your Azure Synapse files to the Snowflake cloud data platform.
Conversion rule or transformation rule: rules that allow SnowConvert AI to convert from a portion of source code to the expected target code.
Parse: parse or parsing is an initial process done by SnowConvert AI to understand the source code and build up an internal data structure required for executing the conversion rules.
On the next few pages, you’ll learn more about the kind of conversions that SnowConvert AI for SQL Server is capable of. If you’re ready to get started, visit the Getting Started page in this documentation.