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

Erreur @@

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 comme erreur, SSMA ignorera la conversion et marquera 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 les opérandes LIKE pour correspondre au comportement de SAP ASE. Le point est que l'ASE supprime les espaces de fin de manière similaire. 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 Convertir en 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 blanches dans CONVERT ou CAST des expressions de 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 est traitée comme zéro numérique est sélectionnée, alors le paramètre de chaîne {s} sera remplacé par l’expression CASE ltrim(rtrim({s})) WHEN "" THEN 0 else {s} END.

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 élément non constant string_expression dans la concaténation sera encapsulé avec ISNULL(string_expression), et les valeurs NULL seront remplacées 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 :

CONVERT et CAST pour la conversion de chaîne binaire

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 les expressions CONVERT et CAST qui contiennent des valeurs binaires :

• 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 pour que SSMA convertisse et corrige les expressions à utiliser sur SQL Server. L’ordre d’octet dans les constantes littérales sera 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 comme erreur, SSMA ignorera la conversion et marquera 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 pour vérifier 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 est désactivé, les comparaisons d'égalité qui contiennent des valeurs NULL renvoient true lorsque la colonne comparée et l’expression ou les deux expressions sont toutes 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 mode si ANSI_NULLS est OFF dans SQL Server/Azure SQL ou si vous souhaitez réviser les comparaisons d'égalité sur une base par cas.
• Si vous sélectionnez Envisager des valeurs NULL, SSMA ajoutera des vérifications pour les valeurs NULL en utilisant les clauses IS NULL et IS NOT NULL.

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 les instructions PRINT et RAISERROR. L'argument format_string permet de placer directement des paramètres remplaçables dans la chaîne, puis de remplacer ces 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 les fonctions PRINT et RAISERROR, sélectionnez Créer une nouvelle 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 pourcentage double (%%) sont modifiés en un seul caractère de pourcentage % 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, comme 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 instruction PRINT et RAISERROR, puis en utilisant cette variable pour la valeur de chaîne de caractères, sélectionnez Créer une variable.

  Dans ce mode, si une instruction PRINT ou RAISERROR n’utilise pas d’espaces réservés et de variables locales, SSMA remplace tous les caractères de double pourcentage (%%) par des caractères de pourcentage simple 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, comme 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 déclarations, sélectionnez Exclure les colonnes.
• 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, les instructions INSERT ne seront pas converties et seront marquées par 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 comme erreur pour simplement marquer 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. C'est afin que les numéros de message convertis ne soient en conflit avec les numéros de message existants.

Notez ce qui suit :

• 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 complet, 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 à la fonction CHARINDEX sont remplacés par un appel à une fonction utilisateur soit CHARINDEX_VARCHAR, soit CHARINDEX_NVARCHAR, selon le type de paramètres passés (créés dans la base de données utilisateur sous le nom de schéma s2ss) pour reproduire le comportement de 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. Toutes les appels de la fonction DATALENGTH sont remplacés par l'expression CASE pour émuler le comportement de 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 que INDEX_COL est rencontré, sélectionnez Marquer comme erreur. SSMA ne convertit pas les références à la fonction et marque l’instruction avec des indications 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 à la fonction INDEX_COLORDER sont remplacés par un appel à une fonction définie par l'utilisateur avec le même nom INDEX_COLORDER (créée dans la base de données utilisateur sous le nom de schéma s2ss) qui émule le comportement SAP ASE.
• Pour imprimer un message d’erreur chaque fois que INDEX_COLORDER est rencontré, sélectionnez Marquer comme une erreur. SSMA ne convertit pas les références à la fonction et marque l’instruction avec des indications 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 que NEXT_IDENTITY est rencontré, sélectionnez Marquer comme une erreur. SSMA ne convertit pas les références à la fonction et marque l’instruction avec des indications 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

Fonction PATINDEX

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 de l'expression de valeur en un type de données de longueur fixe avec une précision maximale et à appliquer la fonction rtrim 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 :

Fonction REPLICATE

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 à la fonction REPLICATE sont remplacés par un appel à une fonction utilisateur soit REPLICATE_VARCHAR, soit REPLICATE_NVARCHAR, selon le type de paramètres passés (créés dans la base de données utilisateur sous le nom de schéma s2ss) pour reproduire le comportement de 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 des fonctions TRIM, LTRIM et RTRIM par la syntaxe équivalente de 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 :

Fonction SUBSTRING

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 à la fonction SUBSTRING sont remplacés par un appel à la fonction définie par l'utilisateur SUBSTRING_VARCHAR, SUBSTRING_NVARCHAR, ou SUBSTRING_VARBINARY en fonction du type de paramètres transmis (créés dans la base de données utilisateur sous le nom de schéma s2ss) pour émuler le comportement de 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 :

Tables de section

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

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