Paramètres du projet (Conversion) (SybaseToSQL)

La page Conversion de la boîte de dialogue Paramètres du projet contient des paramètres qui personnalisent la façon dont SSMA convertit la syntaxe SAP Adaptive Server Enterprise (ASE) en syntaxe SQL Server ou Azure SQL.

Le volet Conversion est disponible dans les boîtes de dialogue Paramètres du projet et Paramètres du projet par défaut :

• Si vous souhaitez spécifier des paramètres pour tous les projets SSMA, dans le menu Outils , sélectionnez Paramètres de projet par défaut, cliquez sur Général en bas du volet gauche, puis sur Conversion.

• Pour spécifier les paramètres du projet actuel, dans le menu Outils , sélectionnez Paramètres du projet, cliquez sur Général en bas du volet gauche, puis sur Conversion.

Section Divers

@@ERROR

SQL Server/Azure SQL et ASE utilisent différents codes d’erreur.

Utilisez ce paramètre pour spécifier le type de message (Avertissement ou Erreur) affiché par SSMA dans le volet Sortie ou Liste d’erreurs lorsqu’il rencontre une référence au @@ERROR code ASE.

• Si vous sélectionnez Convertir et marquer avec avertissement, SSMA convertit les instructions et les marque avec des commentaires d’avertissement.
• Si vous sélectionnez Marquer avec une erreur, SSMA ignore la conversion et marque les instructions avec des commentaires d’erreur.

Lorsque vous sélectionnez un mode de conversion dans la zone Mode , SSMA applique le paramètre suivant :

Conversion de l’opérateur LIKE

Spécifie s’il faut convertir LIKE des opérandes en fonction du comportement SAP ASE. Le point est que l’ASE supprime les espaces de fin dans un modèle semblable. La solution de contournement consiste à convertir une expression de droite en type de données de longueur fixe avec une précision maximale.

• Sélectionnez Conversion simple pour convertir les expressions sans correction.
• Pour utiliser le comportement ASE, sélectionnez Cast sur une longueur fixe.

Lorsque vous sélectionnez un mode de conversion dans la zone Mode, SSMA applique le paramètre suivant :

CONVERTIR ou CAST des chaînes vides en types numériques

Spécifie comment gérer des chaînes vides ou vides dans CONVERT ou CAST des expressions avec un type numérique en tant qu’argument de type de données. Les options suivantes sont disponibles pour ce paramètre :

• Sélectionnez Conversion simple pour convertir les expressions sans correction.
• Si la chaîne vide comme zéro numérique est sélectionnée, le paramètre {s} de chaîne est remplacé par CASE ltrim(rtrim({s})) WHEN "" THEN 0 else {s} END l’expression.

Lorsque vous sélectionnez un mode de conversion dans la zone Mode , SSMA applique le paramètre suivant :

Concaténation de NULL

Ce paramètre spécifie comment convertir la concaténation de chaîne avec NULL. Les options suivantes peuvent être définies pour ce paramètre particulier :

• Si l’option Wrap with ISNULL function est sélectionnée, chaque non constante string_expression en concaténation est encapsulée ISNULL(string_expression) et NULLs est remplacée par une chaîne vide.
• Conserver la syntaxe actuelle conserve la syntaxe d’origine.

Lorsque vous sélectionnez un mode de conversion dans la zone Mode , SSMA applique le paramètre suivant :

Conversion de chaînes vides

Ce paramètre spécifie comment convertir des chaînes vides. Les options suivantes peuvent être définies pour ce paramètre particulier :

• Remplacer toutes les expressions de chaîne par l’espace
• Remplacer les constantes de chaîne vides par l’espace

Pour utiliser le comportement SQL Server/Azure SQL, sélectionnez Conserver la syntaxe actuelle.

Lorsque vous sélectionnez un mode de conversion dans la zone Mode , SSMA applique le paramètre suivant :

Conversion de chaîne binaire CONVERT et CAST

La conversion de valeurs binaires en nombres peut retourner différentes valeurs sur différentes plateformes. Par exemple, sur les processeurs x86, CONVERT(integer, 0x00000100) retourne 65536 dans ASE, mais 256 dans SQL Server. ASE retourne également des valeurs différentes en fonction de l’ordre d’octet.

Utilisez ce paramètre pour contrôler la façon dont SSMA convertit et CAST expressions qui contiennent des valeurs binaires CONVERT :

• Sélectionnez Conversion simple pour convertir les expressions sans avertissements ni correction. Utilisez ce paramètre si vous savez que le serveur ASE a un ordre d’octet qui ne nécessite aucune modification de la valeur binaire.
• Sélectionnez Convertir et corriger la conversion de SSMA et corrigez les expressions à utiliser sur SQL Server. L’ordre d’octet dans les constantes littérales est inversé. Toutes les autres valeurs binaires (telles que les variables binaires et les colonnes) sont marquées avec des erreurs. Utilisez cette valeur si vous savez que le serveur ASE a un ordre d’octet qui nécessite des modifications apportées aux valeurs binaires.

Sélectionnez Convertir et marquer avec avertissement pour que SSMA convertisse et corrige les expressions, puis marquez toutes les expressions converties avec des commentaires d’avertissement.

Lorsque vous sélectionnez un mode de conversion dans la zone Mode , SSMA applique le paramètre suivant :

SQL dynamique

Utilisez ce paramètre pour spécifier le type de message (Avertissement ou Erreur) affiché par SSMA dans le volet Sortie ou Liste d’erreurs lorsqu’il rencontre sql dynamique dans le code ASE.

• Si vous sélectionnez Convertir et marquer avec avertissement, SSMA convertit le code SQL dynamique et marque les instructions avec des commentaires d’avertissement.
• Si vous sélectionnez Marquer avec une erreur, SSMA ignore la conversion et marque les instructions avec des commentaires d’erreur.

Lorsque vous sélectionnez un mode de conversion dans la zone Mode , SSMA applique le paramètre suivant :

Conversion de vérification de l’égalité

Dans SQL Server/Azure SQL, si le ANSI_NULLS paramètre est activé, SQL Server/Azure SQL retourne UNKNOWN quand une comparaison d’égalité contient une NULL valeur. Si ANSI_NULLS elle est désactivée, les comparaisons d’égalité qui contiennent des valeurs retournent NULL true lorsque la colonne et l’expression comparées ou deux expressions sont les deux NULL. Par défaut (ANSINULL OFF) les comparaisons d’égalité SAP ASE se comportent comme SQL Server/Azure SQL avec ANSI_NULLS OFF.

• Si vous sélectionnez Conversion simple, SSMA convertit le code ASE en syntaxe SQL Server/Azure SQL sans vérification supplémentaire des NULL valeurs. Utilisez ce paramètre s’il ANSI_NULLS se trouve OFF dans SQL Server/Azure SQL ou si vous souhaitez réviser les comparaisons d’égalité par cas.
• Si vous sélectionnez Envisager des valeurs NULL, SSMA ajoute des vérifications pour NULL les valeurs à l’aide des clauses et IS NOT NULL des IS NULL clauses.

Lorsque vous sélectionnez un mode de conversion dans la zone Mode , SSMA applique le paramètre suivant :

Chaînes de format

SQL Server/Azure SQL ne prend plus en charge l’argument format_string dans et RAISERROR les PRINT instructions. Argument format_string autorisé à placer des paramètres remplaçables directement dans la chaîne, puis en remplaçant les paramètres au moment de l’exécution. Au lieu de cela, SQL Server requiert la chaîne complète à l’aide d’un littéral de chaîne ou d’une chaîne générée à l’aide d’une variable. Pour plus d’informations, consultez la rubrique PRINT (Transact-SQL).

Lorsque SSMA rencontre un format_string argument, il peut générer un littéral de chaîne à l’aide des variables ou créer une variable et générer une chaîne à l’aide de cette variable.

• Pour utiliser un littéral de chaîne pour PRINT et RAISERROR des fonctions, sélectionnez Créer une chaîne.

  Dans ce mode, si une instruction PRINT ou RAISERROR n’utilise pas d’espaces réservés et de variables locales, l’instruction n’est pas modifiée. Les caractères de double pourcentage (%%) sont remplacés par un pourcentage de caractères unique dans les littéraux de chaîne PRINT.

  Si une instruction PRINT ou RAISERROR utilise des espaces réservés et une ou plusieurs variables locales, comme dans l’exemple suivant :

  PRINT 'Total: %1!%%', @percent
  

  SSMA le convertit en syntaxe suivante :

  PRINT 'Total: '+ CAST(@percent AS varchar(max)) + '%'
  

  S’il s’agit format_string d’une variable, telle que dans l’instruction suivante :

  PRINT @fmt, @arg1, @arg2
  

  SSMA ne peut pas effectuer une conversion de chaîne simple et doit créer une variable :

  DECLARE @print_format_1 varchar(max)
  SET @print_format_1 =
      REPLACE (@fmt, '%%', '%')
  SET @print_format_1 =
      REPLACE (@print_format_1, '%1!',
      CAST (@arg1 AS varchar(max)))
  SET @print_format_1 =
      REPLACE (@print_format_1, '%2!',
      CAST (@arg2 AS varchar(max)))
  PRINT @print_format_1
  

  Quand elle utilise le mode Créer une chaîne , SSMA suppose que l’option CONCAT_NULL_YIELDS_NULL SQL Server est OFF. Par conséquent, SSMA ne vérifie pas les arguments Null.

• Pour que SSMA crée une nouvelle variable pour chaque PRINT instruction RAISERROR , puis utilisez cette variable pour la valeur de chaîne, sélectionnez Créer une variable.

  Dans ce mode, si une PRINT ou RAISERROR une instruction n’utilise pas d’espaces réservés et de variables locales, SSMA remplace tous les caractères%% de pourcentage () par des caractères de pourcentage unique pour se conformer à la syntaxe SQL Server/Azure SQL.

  Si une PRINT ou RAISERROR instruction utilise des espaces réservés et une ou plusieurs variables locales, comme dans l’exemple suivant :

  PRINT 'Total: %1!%%', @percent
  

  SSMA le convertit en syntaxe suivante :

  DECLARE @print_format_1 varchar(max)
  SET @print_format_1 = 'Total: %1!%'
  SET @print_format_1 =
      REPLACE (@print_format_1, '%1!',
      ISNULL(CAST (@percent AS VARCHAR(max)), ''))
  PRINT @print_format_1
  

  S’il s’agit format_string d’une variable, telle que dans l’instruction suivante :

  PRINT @fmt, @arg1, @arg2
  

  SSMA crée une variable comme suit, en vérifiant les valeurs Null dans chaque argument :

  DECLARE @print_format_1 varchar(max)
  SET @print_format_1 =
      REPLACE (@fmt, '%%', '%')
  SET @print_format_1 =
      REPLACE (@print_format_1, '%1!',
      ISNULL(CAST (@arg1 AS varchar(max)),''))
  SET @print_format_1 =
      REPLACE (@print_format_1, '%2!',
      ISNULL(CAST (@arg2 AS varchar(max)),''))
  PRINT @print_format_1
  

Lorsque vous sélectionnez un mode de conversion dans la zone Mode , SSMA applique le paramètre suivant :

Insérer une valeur explicite dans une colonne d’horodatage

SQL Server/Azure SQL ne prend pas en charge l’insertion de valeurs explicites dans une colonne d’horodatage.

• Pour exclure les colonnes d’horodatage des INSERT instructions, sélectionnez Exclure la colonne.
• Pour imprimer un message d’erreur chaque fois qu’une colonne d’horodatage se trouve dans une INSERT instruction, sélectionnez Marquer avec erreur. Dans ce mode, INSERT les instructions ne seront pas converties et seront marquées avec des commentaires d’erreur.

Lorsque vous sélectionnez un mode de conversion dans la zone Mode , SSMA applique le paramètre suivant :

Stocker des objets temporaires définis dans les procédures

Ce paramètre spécifie si les définitions d’objets temporaires qui apparaissent dans les procédures doivent être stockées dans les métadonnées sources pendant la conversion.

• Sélectionnez Oui pour stocker les métadonnées.
• Sélectionnez Non si les objets ne doivent pas être stockés.

Conversion de table proxy

Spécifie si les tables proxy ASE sont converties en tables SQL Server/Azure SQL, ou si elles ne sont pas converties et que le code est marqué avec des commentaires d’erreur.

• Sélectionnez Convertir pour convertir des tables proxy en tables régulières.
• Sélectionnez Marquer avec une erreur pour marquer simplement le code de la table proxy avec des commentaires d’erreur.

Lorsque vous sélectionnez un mode de conversion dans la zone Mode , SSMA applique le paramètre suivant :

Numéro de message de base RAISERROR

Les messages utilisateur ASE sont stockés dans chaque base de données. Les messages utilisateur SQL Server sont stockés de manière centralisée et mis à disposition via l’affichage sys.messages catalogue. En outre, les messages utilisateur ASE commencent à 20000, mais les messages d’erreur SQL Server démarrent à 50001.

Ce paramètre spécifie le nombre à ajouter au numéro de message utilisateur ASE pour le convertir en message utilisateur SQL Server. Si votre serveur SQL Server contient des messages utilisateur dans l’affichage sys.messages catalogue, vous devrez peut-être remplacer ce nombre par une valeur plus élevée. Il s’agit donc des numéros de message convertis qui ne sont pas en conflit avec les numéros de message existants.

Notez les points suivants :

• Les messages ASE de la plage 17000-19999 proviennent de la sysmessages table système et ne sont pas convertis.
• Si le numéro de message référencé dans l’instruction RAISERROR est une constante, SSMA ajoute le numéro de message de base à la constante pour déterminer le nouveau numéro de message utilisateur.
• Si le numéro de message référencé est une variable ou une expression, SSMA crée une variable locale intermédiaire.
• En mode optimiste, SSMA suppose que l’option CONCAT_NULL_YIELDS_NULL SQL Server est OFF et ne vérifie pas les NULL arguments.
• En mode plein, SSMA recherche NULL les arguments.
• RAISERROR avec arg-list argument n’est pas converti.

Lorsque vous sélectionnez un mode de conversion dans la zone Mode , SSMA applique le paramètre suivant :

Objets système

Utilisez ce paramètre pour spécifier le type de message (Avertissement ou Erreur) affiché par SSMA dans le volet Sortie ou Liste d’erreurs lorsqu’il rencontre l’utilisation d’objets système ASE.

• Si vous sélectionnez Convertir et marquer avec avertissement, SSMA convertit les références en objets système et marque les instructions avec des commentaires d’avertissement.
• Si vous sélectionnez Marquer avec une erreur, SSMA ne convertit pas les références en objets système et marque les instructions avec des commentaires d’erreur.

Lorsque vous sélectionnez un mode de conversion dans la zone Mode , SSMA applique le paramètre suivant :

Identificateurs non résolus

Utilisez ce paramètre pour spécifier le type de message (Avertissement ou Erreur) affiché par SSMA dans le volet Sortie ou Liste d’erreurs lorsqu’il ne peut pas résoudre un identificateur.

• Si vous sélectionnez Convertir et marquer avec avertissement, SSMA tente de convertir des références en identificateurs non résolus et marque les instructions avec des commentaires d’avertissement.
• Si vous sélectionnez Marquer avec une erreur, SSMA ne convertit pas les références en identificateurs non résolus et marque les instructions avec des commentaires d’erreur.

Lorsque vous sélectionnez un mode de conversion dans la zone Mode , SSMA applique le paramètre suivant :

Section Fonctions système

FONCTION CHARINDEX

Dans ASE, CHARINDEX retourne NULL uniquement si toutes les expressions d’entrée sont NULL. SQL Server/Azure SQL retourne NULL si une expression d’entrée est NULL.

• Pour utiliser le comportement ASE, sélectionnez Remplacer la fonction. Tous les appels à CHARINDEX la fonction sont remplacés par un appel à CHARINDEX_VARCHAR une fonction définie par l’utilisateur ou CHARINDEX_NVARCHAR par l’utilisateur en fonction du type de paramètres transmis (créés dans la base de données utilisateur sous le nom s2ssdu schéma) pour émuler le comportement SAP ASE.
• Pour utiliser le comportement SQL Server/Azure SQL, sélectionnez Conserver la syntaxe actuelle.

Lorsque vous sélectionnez un mode de conversion dans la zone Mode , SSMA applique le paramètre suivant :

FONCTION DATALENGTH

SQL Server/Azure SQL et ASE diffèrent dans la valeur retournée par la DATALENGTH fonction lorsque la valeur est un espace unique. Dans ce cas, SQL Server/Azure SQL retourne 0 et ASE retourne 1.

• Pour utiliser le comportement ASE, sélectionnez Remplacer la fonction. Tous les appels à DATALENGTH la fonction sont remplacés par CASE une expression pour émuler le comportement SAP ASE.
• Pour utiliser le comportement SQL Server/Azure SQL par défaut, sélectionnez Conserver la syntaxe actuelle.

Lorsque vous sélectionnez un mode de conversion dans la zone Mode , SSMA applique le paramètre suivant :

fonction INDEX_COL

ASE prend en charge un argument facultatif user_id pour la INDEX_COL fonction . Toutefois, SQL Server/Azure SQL ne prend pas en charge cet argument. Si vous utilisez l’argument user_id , cette fonction ne peut pas être convertie en syntaxe SQL Server/Azure SQL.

• Pour utiliser le comportement d’ASE, sélectionnez Convertir la fonction. Si le code contient l’argument user_id , SSMA affiche une erreur.
• Pour afficher un message d’erreur chaque fois qu’il INDEX_COL est rencontré, sélectionnez Marquer avec une erreur. SSMA ne convertit pas les références à la fonction et marque l’instruction avec des commentaires d’erreur.

fonction INDEX_COLORDER

SQL Server/Azure SQL n’a pas de INDEX_COLORDER fonction système.

• Pour utiliser le comportement d’ASE, sélectionnez Convertir la fonction. Tous les appels à INDEX_COLORDER la fonction sont remplacés par un appel à une fonction définie par l’utilisateur portant le même nom INDEX_COLORDER (créé dans la base de données utilisateur sous le nom s2ssde schéma) qui émule le comportement SAP ASE.
• Pour imprimer un message d’erreur chaque fois qu’il INDEX_COLORDER est rencontré, sélectionnez Marquer avec une erreur. SSMA ne convertit pas les références à la fonction et marque l’instruction avec des commentaires d’erreur.

Lorsque vous sélectionnez un mode de conversion dans la zone Mode , SSMA applique le paramètre suivant :

Fonctions GAUCHE et DROITE

LEFT et RIGHT les fonctions dans ASE se comportent différemment pour le paramètre de longueur négative.

• Pour utiliser le comportement asE, sélectionnez Remplacer la fonction. Le paramètre de longueur est ensuite remplacé par CASE une expression qui retourne NULL une valeur négative.
• Pour utiliser le comportement de SQL Server, sélectionnez Conserver la syntaxe actuelle.

Lorsque vous sélectionnez un mode de conversion dans la zone Mode , SSMA applique le paramètre suivant :

fonction NEXT_IDENTITY

SQL Server/Azure SQL n’a pas de NEXT_IDENTITY fonction système.

• Pour utiliser le comportement d’ASE, sélectionnez Convertir la fonction. Tous les appels à NEXT_IDENTITY la fonction sont remplacés par une expression (IDENT_CURRENT(parameter Value) + IDENT_INCR(parameter Value) qui émule le comportement SAP ASE.
• Pour imprimer un message d’erreur chaque fois qu’il NEXT_IDENTITY est rencontré, sélectionnez Marquer avec une erreur. SSMA ne convertit pas les références à la fonction et marque l’instruction avec des commentaires d’erreur.

Lorsque vous sélectionnez un mode de conversion dans la zone Mode , SSMA applique le paramètre suivant :

Mode par défaut/optimiste/plein : marquer avec une erreur

PATINDEX, fonction

Spécifie s’il faut convertir PATINDEX une fonction en fonction du comportement SAP ASE. Le point est que l’ASE supprime les espaces de fin dans un modèle de recherche. La solution de contournement consiste à effectuer un cast d’expression de valeur en type de données de longueur fixe avec une précision maximale et à appliquer rtrim une fonction au modèle de recherche.

• Pour utiliser le comportement ASE, sélectionnez Utiliser.
• Pour utiliser le comportement SQL Server/Azure SQL par défaut, sélectionnez Ne pas utiliser.

Lorsque vous sélectionnez un mode de conversion dans la zone Mode , SSMA applique le paramètre suivant :

REPLICATE (fonction)

La REPLICATE fonction répète une chaîne le nombre spécifié de fois. Dans ASE, si vous spécifiez de répéter la chaîne zéro fois, le résultat est NULL. Dans SQL Server/Azure SQL, le résultat est une chaîne vide.

• Pour utiliser le comportement ASE, sélectionnez Remplacer la fonction. Tous les appels à REPLICATE la fonction sont remplacés par un appel à REPLICATE_VARCHAR une fonction définie par l’utilisateur ou REPLICATE_NVARCHAR par l’utilisateur en fonction du type de paramètres transmis (créés dans la base de données utilisateur sous le nom s2ssdu schéma) pour émuler le comportement SAP ASE.
• Pour utiliser le comportement SQL Server/Azure SQL par défaut, sélectionnez Remplacer la fonction.

Lorsque vous sélectionnez un mode de conversion dans la zone Mode , SSMA applique le paramètre suivant :

FONCTION TRIM (LTRIM, RTRIM)

Ce paramètre spécifie s’il faut remplacer les appels et les fonctions par les fonctions de syntaxe équivalentes à TRIMLTRIM RTRIM SAP ASE ou conserver la syntaxe actuelle. Les options suivantes sont présentes pour ce paramètre particulier :

• Remplacer la fonction
• Conserver la syntaxe actuelle

Lorsque vous sélectionnez un mode de conversion dans la zone Mode , SSMA applique le paramètre suivant :

SUBSTRING (fonction)

Dans ASE, la fonction SUBSTRING(expression, start, length) retourne NULL si une valeur de début supérieure au nombre de caractères dans l’expression est spécifiée, ou si la longueur est égale à zéro. Dans SQL Server/Azure SQL, l’expression équivalente retourne une chaîne vide.

• Pour utiliser le comportement ASE, sélectionnez Remplacer la fonction. Tous les appels à SUBSTRING la fonction sont remplacés par un appel ou SUBSTRING_NVARCHAR SUBSTRING_VARCHAR SUBSTRING_VARBINARY une fonction définie par l’utilisateur en fonction du type de paramètres transmis (créés dans la base de données utilisateur sous le nom s2ssde schéma) pour émuler le comportement SAP ASE.
• Pour utiliser le comportement SQL Server/Azure SQL, sélectionnez Conserver la syntaxe actuelle.

Lorsque vous sélectionnez un mode de conversion dans la zone Mode , SSMA applique le paramètre suivant :

Section Tables

Ajouter une clé primaire

Crée une clé primaire dans la table SQL Server ou Azure SQL si une table SAP ASE n’a pas de clé primaire ou d’index unique.

Voir aussi

Guide de référence de l’interface utilisateur (SybaseToSQL)