Caché Transact-SQL (TSQL) Migration Guide - InterSystems ...

OverviewAlternatively, you can invoke $SYSTEM.SQL.TSQL(), $SYSTEM.SQL.Sybase() or$SYSTEM.SQL.MSSQLServer() method to import the schema. For further details, see the InterSystems Class Reference.If the TSQL source contains CREATE PROC statements, then a class method containing the CREATE PROC sourceis created. Caché places this class method in either an existing class or in a new class whose name is based on theschema and procedure name. If the procedure already exists, then the existing version is replaced by the new version.If a class matching the class name generated from the schema and procedure already exists, then this class name isused — if it was previously generated by the TSQL utility. If not, then a unique class name is generated, based on theschema and procedure name. The resulting class is compiled once the procedure has been successfully created. If loggingis requested then the source statements are logged along with the name of the containing class, class method, and theformal arguments generated. Any errors encountered by the process are also reported in the log. If an error is detectedduring CREATE PROC processing, Caché deletes any new class that was generated for that procedure.2. Migrate DML and Stored Procedures: These are generally in *.sql files and can be loaded using the following command:DO ##class(%TSQL.Manager).Import(...)Set this method's pDialect parameter to either MSSQL or Sybase. For further details, see the InterSystems Class Reference.The %TSQL.Manager.Import method imports (loads) TSQL source code of all types: DDL, DML, and stored procedures.This is the method to use when DDL and DML are found in the same file. However, when possible, it is preferable toimport table and view definition files separately using %SYSTEM.SQL.DDLImport, as described above.3. Inspect the log file for errors: Search by Error #. A summary count of errors and successful imports will appear at theend of the log. In most cases, errors can be worked around or addressed by using information found in this document.4. Compile: When you import DDL, table and view definition compilation is automatically performed. To compile otherTSQL source code, it is best to use the command as follows:DO $SYSTEM.OBJ.CompileAll("-l")The lowercase “L” qualifier flag specifies that locking is not applied for the duration of the compile. For a full list offlag qualifiers, call DO $SYSTEM.OBJ.ShowFlags().1.1.3 Migrating the DataIn the Management Portal select [System] > [SQL], then select the Data Migration Wizard.1.2 TSQL Language ImplementationTSQL procedures are converted to Caché methods or queries with a Language type equal to TSQL. Use the followingcommand:DO ##class(%TSQL.Manager).load("sybase",,)When compiling TSQL methods, Caché ObjectScript code is generated. There is no system-level support for native TSQL.It is best to maintain the methods in TSQL to retain the familiar look of the original stored procedures.• Using TSQL in StudioYou can write and maintain TSQL stored procedures (SPs) in Caché Studio. A TSQL SP can be either a class methodor a query. A class method takes parameters and returns a single scalar result, a query takes parameters and returns4 Caché Transact-SQL (TSQL) Migration Guide