• Article

Éditeur de tâche d'exécution SQL (page Général)

Utilisez la page Général de la boîte de dialogue Éditeur de tâche d'exécution SQL pour configurer la tâche d'exécution SQL et indiquer l'instruction SQL que la tâche exécuter.

Pour en savoir plus sur cette tâche, consultez Tache d'exécution de requêtes SQL, Utilisation de paramètres et de codes de retour dans la tâche d'exécution SQL et Utilisation de jeux de résultats dans la tâche d'exécution SQL. Pour en savoir plus sur le langage de requête Transact-SQL, consultez Référence Transact-SQL (moteur de base de données).

Options statiques

  • Name
    Donnez un nom unique à la tâche d'exécution SQL dans le flux de travail. Le nom fourni est affiché dans le concepteur SSIS.

  • Description
    Décrit la tâche d'exécution SQL. Pour réaliser des packages autodocumentés plus faciles à maintenir, fournissez une description de la tâche en rapport avec son objectif.

  • TimeOut
    Spécifiez le nombre maximal de secondes d'exécution de la tâche au terme duquel le délai d'attente expire. La valeur 0 indique un délai infini. La valeur par défaut est 0.

    [!REMARQUE]

    Les procédures stockées ne sont par concernées par le délai d'expiration si elles émulent la fonctionnalité de veille en laissant le temps nécessaire à l'établissement des connexions et à la réalisation des transactions qui est supérieur au nombre de secondes spécifié par l'option TimeOut. Cependant, les procédures stockées qui exécutent des requêtes sont toujours soumises à la limitation de temps spécifiée dans TimeOut.

  • CodePage
    Spécifiez la page de codes à utiliser pour la traduction des valeurs Unicode en variables. Il s'agit par défaut de la page de codes de l'ordinateur local.

    [!REMARQUE]

    Lorsque la tâche d'exécution SQL utilise un gestionnaire de connexions ADO ou ODBC, la propriété CodePage n'est pas disponible. Si votre solution requiert l'utilisation d'une page de codes, utilisez un gestionnaire de connexions OLE DB ou ADO.NET avec la tâche d'exécution SQL.

  • ResultSet
    Spécifiez le type de résultats attendu par l'instruction SQL en cours d'exécution. Choisissez parmi les options suivantes : Ligne unique, Ensemble de résultats complet, XML ou Aucun.

  • ConnectionType
    Choisissez le type de gestionnaire de connexions à utiliser pour vous connecter à la source de données. Les types de connexions disponibles sont OLE DB, ODBC, ADO, ADO.NET et SQLMOBILE.

    Rubriques connexes :Gestionnaire de connexions OLE DB, Gestionnaire de connexions ODBC, Gestionnaire de connexions ADO, Gestionnaire de connexions ADO.NET, Gestionnaire de connexions de SQL Server Compact Edition

  • Connection
    Choisissez la connexion dans la liste des gestionnaires de connexions définis. Pour créer une connexion, sélectionnez <Nouvelle connexion...>.

  • SQLSourceType
    Sélectionnez le type de source de l'instruction SQL qui exécute la tâche.

    Selon le type de gestionnaire de connexions que la tâche d'exécution SQL utilise, vous devez utiliser des marqueurs de paramètres spécifiques dans les instructions SQL paramétrées.

    Rubriques connexes : section relative à l'exécution des commandes SQL paramétrables dans Tache d'exécution de requêtes SQL

    Cette propriété dispose des options répertoriées dans le tableau suivant.

    Valeur

    Description

    Entrée directe

    Définissez la source d'une instruction Transact-SQL. Sélectionnez cette valeur pour afficher l'option dynamique SQLStatement.

    Connexion de fichiers

    Sélectionnez un fichier qui contient une instruction Transact-SQL. Configurez cette option pour afficher l'option dynamique FileConnection.

    Variable

    Définissez la source sur une variable qui définit l'instruction Transact-SQL. Sélectionnez cette valeur pour afficher l'option dynamique SourceVariable.

  • QueryIsStoredProcedure
    Indique si l'instruction SQL spécifiée à exécuter est une procédure stockée. Cette propriété est en lecture/écriture uniquement si la tâche utilise le gestionnaire de connexions ADO. Sinon, elle est en lecture seule ; sa valeur est alors false.

  • BypassPrepare
    Indique si l'instruction SQL est préparée. La valeur true ignore la préparation ; false prépare l'instruction avant de l'exécuter. Cette option est disponible uniquement avec les connexions OLE DB qui prennent en charge la préparation.

    Rubriques connexes : Exécution préparée

  • Parcourir
    Utilisez la boîte de dialogue Ouvrir pour rechercher un fichier qui contient une instruction SQL. Sélectionnez un fichier dont vous voulez copier le contenu en tant qu'instruction SQL dans la propriété SQLStatement.

  • Générer une requête
    Créez une instruction SQL au moyen de la boîte de dialogue Générateur de requêtes : il s'agit d'un outil graphique de création de requêtes. Cette option est disponible lorsque l'option SQLSourceType est configurée avec Entrée directe.

  • Analyser la requête
    Valide la syntaxe de l’instruction SQL.

Options dynamiques SQLSourceType

SQLSourceType = Entrée directe

  • SQLStatement
    Dans la zone des options, tapez l'instruction SQL à exécuter ou cliquez sur le bouton d'exploration (…) pour taper l'instruction SQL dans la boîte de dialogue Entrer une requête SQL. Vous pouvez également cliquer sur Générer la requête pour composer l'instruction en utilisant la boîte de dialogue Générateur de requêtes.

    Rubriques connexes :Générateur de requêtes

SQLSourceType = Connexion de fichiers

SQLSourceType = Variable