Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Aplica-se a:
SQL Server SSIS Integration Runtime em Azure Data Factory
O SQL Server Integration Services fornece um conjunto de variáveis do sistema que armazenam informação sobre o pacote em execução e os seus objetos. Estas variáveis podem ser usadas em expressões e expressões de propriedades para personalizar pacotes, contentores, tarefas e gestores de eventos.
Todas as variáveis — sistema e definidas pelo utilizador — podem ser usadas nas associações de parâmetros que a tarefa Executar SQL utiliza para mapear variáveis para parâmetros.
Variáveis do Sistema para Pacotes
A tabela seguinte descreve as variáveis do sistema que o Integration Services fornece para os pacotes.
| Variável do sistema | Tipo de dados | Description |
|---|---|---|
| CancelEvento | Int32 | O identificador (handle) de um objeto de Evento do Windows que a tarefa pode utilizar para sinalizar que deve parar de ser executada. |
| ContainerStartTime | DateTime | A hora de início do container. |
| Data de Criação | DateTime | A data em que o pacote foi criado. |
| CreatorComputerName | Corda | O computador onde o pacote foi criado. |
| CreatorName | Corda | O nome da pessoa que desenvolveu o pacote. |
| ExecutionInstanceGUID | Corda | O identificador único da instância em execução de um pacote. |
| ConfiguraçõesFalhadas | Corda | Os nomes das configurações de pacotes que falharam. |
| IgnoreConfigurationsOnLoad | booleano | Indica se as configurações do pacote são ignoradas ao carregar o pacote. |
| Modo Interativo | booleano | Indica se o pacote está a correr em modo interativo. Se um pacote estiver a correr no SSIS Designer, esta propriedade é definida como True. Se um pacote estiver a correr usando a utilidade do prompt de comandos DTExec , a propriedade é definida como Falso. |
| LocaleId | Int32 | A localização que o pacote utiliza. |
| Nome da máquina | Corda | O nome do computador onde o pacote está a correr. |
| ModoOffline | booleano | Indica se o pacote está no modo offline. O modo offline não adquire ligações a fontes de dados. |
| PackageID | Corda | O identificador único da embalagem. |
| PackageName | Corda | O nome do pacote. |
| Horário de Início | DateTime | A hora em que o pacote começou a funcionar. |
| ServerExecutionID | Int64 | ID de execução para o pacote que é executado no servidor de Serviços de Integração. O valor padrão é zero. O valor só é alterado se o pacote for executado pelo ISServerExec no Integration Services Server. Quando existe um pacote filho, o valor é passado do pacote pai para o pacote filho. |
| UserName | Corda | A conta do utilizador que iniciou o pacote. O nome de utilizador é qualificado pelo nome de domínio. |
| VersãoConstrução | Int32 | A versão do pacote. |
| Comentário de Versão | Corda | Comentários sobre a versão do pacote. |
| VersionGUID | Corda | O identificador único da versão. |
| VersionMajor | Int32 | A versão principal do pacote. |
| VersionMinor | Int32 | A versão menor do pacote. |
Variáveis do sistema para contentores
A tabela seguinte descreve as variáveis do sistema que os Serviços de Integração fornecem para os contentores For Loop, Foreach Loop e Sequence.
| Variável do sistema | Tipo de dados | Description | Container |
|---|---|---|---|
| LocaleId | Int32 | O local que o contentor utiliza. | Para o contentor de laços Contentor 'Foreach Loop' Contentor de sequência |
Variáveis do Sistema para Tarefas
A tabela seguinte descreve as variáveis do sistema que os Serviços de Integração fornecem para tarefas.
| Variável do sistema | Tipo de dados | Description |
|---|---|---|
| CreationName | Corda | O nome da tarefa. |
| LocaleId | Int32 | O local que a tarefa utiliza. |
| TaskID | Corda | O identificador único de uma instância de tarefa. |
| TaskName | Corda | O nome da instância da tarefa. |
| TaskTransactionOption | Int32 | A opção de transação que a tarefa utiliza. |
Variáveis do Sistema para Gestores de Eventos
A tabela seguinte descreve as variáveis do sistema que os Serviços de Integração fornecem para os gestores de eventos. Nem todas as variáveis estão disponíveis para todos os gestores de eventos.
| Variável do sistema | Tipo de dados | Description | Manipulador de eventos |
|---|---|---|---|
| Cancelar | booleano | Indica se o gestor de eventos para de ser executado quando ocorre um erro, aviso ou cancelamento de consulta. | Manipulador de eventos OnError Handler de eventos OnWarning Handler de eventos OnQueryCancel |
| Código de erro | Int32 | O identificador de erro. | Manipulador de eventos OnError Manipulador de eventos OnInformation Handler de eventos OnWarning |
| Descrição do erro | Corda | A descrição do erro. | Manipulador de eventos OnError Manipulador de eventos OnInformation Handler de eventos OnWarning |
| Estado da execução | booleano | O estado atual da execução. | Manipulador de eventos OnExecStatusChanged |
| ExecutionValue | DBNull | O valor de execução. | Manipulador de eventos OnTaskFailed |
| LocaleId | Int32 | O local que o gestor de eventos utiliza. | Todos os gestores de eventos |
| Percentualmente Concluída | Int32 | A percentagem de trabalho concluído. | Handler de eventos OnProgress |
| ProgressCountHigh | Int32 | A parte alta de um valor de 64 bits que indica o número total de operações processadas pelo evento OnProgress. | Handler de eventos OnProgress |
| ContagemProgressoBaixa | Int32 | A parte baixa de um valor de 64 bits indica o número total de operações processadas pelo evento OnProgress. | Handler de eventos OnProgress |
| Descrição do Progresso | Corda | Descrição do progresso. | Handler de eventos OnProgress |
| Propagar | booleano | Indica se o evento é propagado para um gestor de eventos de nível superior. Nota: O valor da variável Propagate é ignorado durante a validação do pacote. Se definir Propagate como False num pacote filho, isso não impede que um evento se propague para cima até ao pacote pai. |
Todos os gestores de eventos |
| Descrição da Fonte | Corda | A descrição do executável no gestor de eventos que gerou o evento. | Todos os gestores de eventos |
| SourceID | Corda | O identificador único do executável no handler de eventos que gerou o evento. | Todos os gestores de eventos |
| Nome da Fonte | Corda | O nome do executável no manipulador de eventos que gerou o evento. | Todos os gestores de eventos |
| Descrição de Variável | Corda | A descrição da variável. | Handler de eventos OnVariableValueChanged |
| VariableID | Corda | O identificador único da variável. | Handler de eventos OnVariableValueChanged |
Variáveis do Sistema em Ligações de Parâmetros
É frequentemente útil guardar os valores das variáveis do sistema em tabelas quando o pacote é executado. Por exemplo, um pacote que cria dinamicamente uma tabela e escreve o GUID da instância de execução do pacote que criou a tabela numa coluna de tabela.
Se usar variáveis de sistema para mapear parâmetros na instrução SQL que uma tarefa Executar SQL utiliza, é importante definir o tipo de dado de cada ligação de parâmetro ao tipo de dados da variável do sistema. Caso contrário, os valores das variáveis do sistema podem ser traduzidos incorretamente. Por exemplo, se a variável do sistema ExecutionInstanceGUID , que tem o tipo de dados string e contém uma string que representa o GUID da instância em execução de um pacote, for usada numa ligação de parâmetros com o tipo de dado GUID, o GUID da instância do pacote será traduzido incorretamente.
Esta regra aplica-se também a variáveis definidas pelo utilizador. Mas, enquanto os tipos de dados das variáveis do sistema não podem ser alterados e é necessário adaptar o uso dessas variáveis para se ajustarem aos tipos de dados, os definidos pelo utilizador são mais flexíveis. As variáveis definidas pelo utilizador que são usadas nas ligações de parâmetros são geralmente definidas com tipos de dados compatíveis com os tipos de dados dos parâmetros para os quais são mapeadas.
Tarefas relacionadas
Mapear parâmetros de consulta para variáveis numa tarefa de execução SQL