Partilhar via

Catálogo do SSIS

  • Artigo

O SSISDB catálogo é o ponto central para trabalhar com projetos do SSIS (Integration Services) implantados no servidor do Integration Services. Por exemplo, você define parâmetros de projeto e pacote, configura ambientes para especificar valores de runtime para pacotes, executa e soluciona problemas de pacotes, e gerencia as operações de servidor do Integration Services .

Os objetos armazenados no SSISDB catálogo incluem projetos, pacotes, parâmetros, ambientes e histórico operacional.

Você inspeciona objetos, configurações e dados operacionais armazenados no SSISDB catálogo consultando as exibições no SSISDB banco de dados. Você gerencia os objetos chamando procedimentos armazenados no SSISDB banco de dados ou usando a interface do usuário do SSISDB catálogo. Em muitos casos, a mesma tarefa pode ser executada na interface de usuário ou chamando um procedimento armazenado.

Para manter o banco de dados SSISDB, é recomendado que você aplique políticas empresariais padrão para gerenciar os bancos de dados de usuários. Para obter informações sobre como criar planos de manutenção, consulte Maintenance Plans.

O SSISDB catálogo e o banco de dados dão SSISDB suporte a Windows PowerShell. Para obter mais informações sobre como usar o SQL Server com Windows PowerShell, consulte SQL Server PowerShell. Para obter exemplos de como usar o Windows PowerShell para concluir tarefas como implantar um projeto, consultar a entrada de blog, SSIS e PowerShell no SQL Server 2012em blogs.msdn.com.

Para obter mais informações sobre como exibir dados de operações, consulte Monitoramento de execuções de pacote e outras operações.

Você acessa o SSISDB catálogo em SQL Server Management Studio conectando-se ao Mecanismo de Banco de Dados SQL Server e, em seguida, expandindo o nó Catálogos do Integration Services em Pesquisador de Objetos. Você acessa o SSISDB banco de dados em SQL Server Management Studio expandindo o nó Bancos de Dados em Pesquisador de Objetos.

Observação

Não é possível renomear o SSISDB banco de dados.

Observação

Se o SQL Server instância à qual o SSISDB banco de dados está anexado, parar ou não responder, o processo ISServerExec.exe terminará. Uma mensagem é gravada em um log de Eventos do Windows.

Se o SQL Server failover de recursos como parte de um failover de cluster, os pacotes em execução não serão reiniciados. Você pode usar pontos de verificação para reiniciar pacotes. Para saber mais, confira Restart Packages by Using Checkpoints.

Identificadores do objeto de catálogo

Quando você cria um novo objeto no catálogo, atribua um nome ao objeto. O nome do objeto é um identificador. OSQL Server define regras que estabelecem que os caracteres podem ser usados em um identificador. Os nomes destes objetos devem seguir as regras de identificador.

  • Pasta

  • Project

  • Ambiente

  • Parâmetro

  • Variável de ambiente

Pasta, projeto, ambiente

Considere as seguintes regras ao renomear uma pasta, um projeto ou um ambiente.

  • Os caracteres inválidos incluem caracteres ASCII/Unicode de 1 a 31, aspas ("), menor que (<), maior que (>), barra vertical (|), Backspace (\b), nulo (\0) e Tab (\t).

  • O nome não pode conter espaços à esquerda ou à direita.

  • @ não é permitido como primeiro caractere, mas os caracteres subsequentes podem usar @.

  • O comprimento do nome deve ser maior ou igual a 0 e menor ou igual a 128.

Parâmetro

Considere as seguintes regras ao nomear um parâmetro.

  • O primeiro caractere do nome deve ser uma letra, conforme definido no Unicode Standard 2.0, ou um caractere de sublinhado (_).

  • Os caracteres subsequentes podem ser letras ou números, conforme definido no Unicode Standard 2.0, ou um caractere de sublinhado (_).

Variável de ambiente

Considere as seguintes regras ao nomear uma variável de ambiente.

  • Os caracteres inválidos incluem caracteres ASCII/Unicode de 1 a 31, aspas ("), menor que (<), maior que (>), barra vertical (|), Backspace (\b), nulo (\0) e Tab (\t).

  • O nome não pode conter espaços à esquerda ou à direita.

  • @ não é permitido como primeiro caractere, mas os caracteres subsequentes podem usar @.

  • O comprimento do nome deve ser maior ou igual a 0 e menor ou igual a 128.

  • O primeiro caractere do nome deve ser uma letra, conforme definido no Unicode Standard 2.0, ou um caractere de sublinhado (_).

  • Os caracteres subsequentes podem ser letras ou números, conforme definido no Unicode Standard 2.0, ou um caractere de sublinhado (_).

Configuração do catálogo

Você ajusta como o catálogo se comporta ajustando as propriedades do catálogo. As propriedades do catálogo definem como os dados confidenciais serão criptografados, e como as operações e os dados de controle de versão de projeto serão retidos. Para definir as propriedades do catálogo, use a caixa de diálogo Propriedades do Catálogo ou chame o procedimento armazenado catalog.configure_catalog (Banco de dados SSISDB). Para exibir as propriedades, use a caixa de diálogo ou consulte catalog.catalog_properties (Banco de dados SSISDB). Acesse a caixa de diálogo clicando com o botão direito do mouse em SSISDB no Pesquisador de Objetos.

Operações e limpeza de versão do projeto

Os dados de status de muitas operações no catálogo são armazenados nas tabelas de banco de dados internas. Por exemplo, o catálogo rastreia o status das execuções de pacote e das implantações de projeto. Para manter o tamanho dos dados de operações, o Trabalho de Manutenção do Servidor SSIS no SQL Server Management Studio é usado para remover dados antigos. Este trabalho do SQL Server Agent é criado quando Integration Services é instalado.

Você pode atualizar ou reimplantar um projeto do Integration Services implantando-o com o mesmo nome na mesma pasta do catálogo. Por padrão, sempre que você reimplanta um projeto, o SSISDB catálogo retém a versão anterior do projeto. Para manter o tamanho dos dados de operações, o Trabalho de Manutenção do Servidor SSIS é usado para remover versões antigas de projetos.

As propriedades de SSISDB catálogo a seguir definem como esse trabalho SQL Server Agent se comporta. Você pode exibir e modificar as propriedades usando a caixa de diálogo Propriedades do Catálogo ou usando catalog.catalog_properties (Banco de dados SSISDB) e catalog.configure_catalog (Banco de dados SSISDB).

Limpar Logs Periodicamente
A etapa de trabalho para limpeza de operações é executada quando esta propriedade é definida como True.

Período de Retenção (dias)
Define a idade máxima dos dados de operações permitidos (em dias). Os dados mais antigos são removidos.

O valor mínimo é um dia. O valor máximo é limitado apenas pelo valor máximo dos dados SQL Serverint. Para obter informações sobre esse tipo de dados, confira int, bigint, smallint e tinyint (Transact-SQL).

Remover Periodicamente Versões Antigas
A etapa de trabalho para limpeza de versão de projeto é executada quando esta propriedade é definida como True.

Número Máximo de Versões por Projeto
Define quantas versões de um projeto são armazenadas no catálogo. As versões de projetos mais antigas são removidas.

Algoritmo de Criptografia

A propriedade Algoritmo de Criptografia especifica o tipo de criptografia usado para criptografar valores de parâmetro confidenciais. Você pode escolher entre os seguintes tipos de criptografia.

  • AES_256 (padrão)

  • AES_192

  • AES_128

  • DESX

  • TRIPLE_DES_3KEY

  • TRIPLE_DES

  • DES

Quando você implanta um projeto do Integration Services no Integration Servicesserver, o catálogo criptografa automaticamente os dados do pacote e os valores confidenciais. O catálogo também descriptografa automaticamente os dados quando você recupera-os. O catálogo SSISDB usa o nível de proteção ServerStorage. Para obter mais informações, consulte Access Control for Sensitive Data in Packages.

Alterar o algoritmo de criptografia é uma operação demorada. Primeiro, o servidor tem que usar o algoritmo previamente especificado para descriptografar todos os valores de configuração. Em seguida, o servidor tem que usar o novo algoritmo para criptografar novamente os valores. Durante este momento, não pode haver outras operações do Integration Services no servidor. Assim, para permitir que operações do Integration Services continuem ininterruptas, o algoritmo de criptografia deverá ser um valor somente leitura na caixa de diálogo do Management Studio.

Para alterar a configuração da propriedade Algoritmo de Criptografia , defina o SSISDB banco de dados como o modo de usuário único e, em seguida, chame o catalog.configure_catalog procedimento armazenado. Use ENCRYPTION_ALGORITHM para o argumento property_name . Para os valores de propriedade com suporte, confira catalog.catalog_properties (Banco de dados SSISDB). Para obter mais informações sobre o procedimento armazenado, veja catalog.configure_catalog (Banco de dados SSISDB).

Para obter mais informações sobre o modo de usuário único, veja Definir um banco de dados como modo de usuário único. Para obter informações sobre criptografia e algoritmos de criptografia no SQL Server, consulte os tópicos na seção Criptografia do SQL Server.

Uma chave mestra de banco de dados é usada para a criptografia. A chave é criada quando você cria o catálogo. Para obter mais informações, consulte Criar o catálogo SSIS.

A tabela a seguir lista os nomes de propriedade mostrados na caixa de diálogo Propriedades do Catálogo e as propriedades correspondentes na exibição de banco de dados.

Nome da Propriedade (caixa de diálogoPropriedades do Catálogo ) Nome da Propriedade (exibição de banco de dados)
Nome do Algoritmo de Criptografia ENCRYPTION_ALGORITHM
Limpar Logs Periodicamente OPERATION_CLEANUP_ENABLED
Período de Retenção (dias) RETENTION_WINDOW
Remover Periodicamente Versões Antigas VERSION_CLEANUP_ENABLED
Número Máximo de Versões por Projeto MAX_PROJECT_VERSIONS
Nível de Log Padrão em Todo o Servidor SERVER_LOGGING_LEVEL

Permissões

Os projetos, ambientes e pacotes são armazenados em pastas, que são objetos protegíveis. Você pode conceder permissões a uma pasta, incluindo a permissão MANAGE_OBJECT_PERMISSIONS. MANAGE_OBJECT_PERMISSIONS permite delegar a administração do conteúdo da pasta a um usuário sem precisar conceder a associação do usuário à função ssis_admin. Você também pode conceder permissões para projetos, ambientes e operações. As operações incluem inicializar o Integration Services, implantar projetos, criar e iniciar execuções, validar projetos e pacotes e configurar o SSISDB catálogo.

Para obter mais informações sobre as funções de banco de dados, veja Funções no nível de banco de dados.

O catálogo SSISDB usa um gatilho DDL, ddl_cleanup_object_permissions, para impor a integridade das informações de permissões para elementos protegíveis do SSIS. O gatilho é acionado quando uma entidade de segurança de banco de dados, como um usuário de banco de dados, função de banco de dados ou função de aplicativo de banco de dados, é removida do banco de dados SSISDB.

Se a entidade de segurança tiver concedido ou negado permissões a outras entidades de segurança, revogue as permissões dadas pelo concessor, para que a entidade de segurança possa ser removida. Caso contrário, uma mensagem de erro será retornada quando o sistema tentar remover a entidade de segurança. O gatilho removerá todos os registros de permissão em que a entidade de segurança de banco de dados é um usuário autorizado.

É recomendável que o gatilho não esteja desabilitado porque garante que não haja registros de permissão órfãos depois que uma entidade de banco de dados for removida do SSISDB banco de dados.

Gerenciando permissões

Você pode gerenciar permissões usando a interface do usuário do SQL Server Management Studio , procedimentos armazenados e o namespace Microsoft.SqlServer.Management.IntegrationServices .

Para gerenciar permissões usando a interface do usuário do SQL Server Management Studio, use as caixas de diálogo a seguir.

Para gerenciar permissões usando Transact-SQL, chame catalog.grant_permission (Banco de Dados SSISDB),catalog.deny_permission (Banco de Dados SSISDB) e catalog.revoke_permission (Banco de Dados SSISDB). Para exibir as permissões em vigor da entidade de segurança atual para todos os objetos, confira catalog.effective_object_permissions (Banco de dados SSISDB). Este tópico fornece descrições dos diferentes tipos de permissões. Para exibir as permissões atribuídas explicitamente ao usuário, confira catalog.explicit_object_permissions (Banco de dados SSISDB).

Pastas

Uma pasta contém um ou mais projetos e ambientes no SSISDB catálogo. Você pode usar a exibição catalog.folders (Banco de dados SSISDB) para acessar informações sobre pastas no catálogo. Você pode usar os procedimentos armazenados a seguir para gerenciar pastas.

Projetos e pacotes

Cada projeto pode conter vários pacotes. Os projetos e pacotes podem conter parâmetros e referências a ambientes. Você pode acessar os parâmetros e referências de ambiente usando a Configure Dialog Box.

Você pode executar outras tarefas de projeto chamando os seguintes procedimentos armazenados.

Estas exibições fornecem detalhes sobre pacotes, projetos e versões de projeto.

Parâmetros

Use os parâmetros para atribuir valores às propriedades de pacote no tempo de execução do pacote. Para definir o valor de um pacote ou parâmetro de projeto e limpar o valor, chame catalog.set_object_parameter_value (Banco de dados SSISDB) e catalog.clear_object_parameter_value (Banco de dados SSISDB). Para definir o valor de um parâmetro para uma instância de execução, chame catalog.set_execution_parameter_value (Banco de dados SSISDB). Você pode recuperar valores de parâmetro padrão chamando catalog.get_parameter_values (Banco de dados SSISDB).

Estas exibições mostram os parâmetros de todos os pacotes e projetos, e os valores de parâmetro usados para uma instância de execução.

Ambientes de servidor, variáveis de servidor e referências de ambiente de servidor

Os ambientes de servidor contêm variáveis de servidor. Os valores variáveis podem ser usados quando um pacote é executado ou validado no servidor do Integration Services .

Os procedimentos armazenados a seguir permitem executar muitas outras tarefas de gerenciamento para ambientes e variáveis.

Ao chamar o procedimento armazenado catalog.set_environment_variable_protection (Banco de dados SSISDB), você pode definir o bit de sensibilidade de uma variável.

Para usar o valor de uma variável de servidor, especifique a referência entre o projeto e o ambiente de servidor. Você pode usar os procedimentos armazenados para criar e excluir referências. Você também pode indicar se o ambiente pode estar localizado na mesma pasta que o projeto ou em uma pasta diferente.

Para obter mais detalhes sobre ambientes e variáveis, consulte estas exibições.

Execuções e validações

Uma execução é uma instância de uma execução de pacote. Chame catalog.create_execution (Banco de dados SSISDB) e catalog.start_execution (Banco de dados SSISDB) para criar e iniciar uma execução. Para interromper a execução ou uma validação de pacote/projeto, chame catalog.stop_operation (Banco de dados SSISDB).

Para fazer com que um pacote em execução pause ou crie um arquivo de despejo, chame o procedimento armazenado catalog.create_execution_dump. Um arquivo de despejo fornece informações sobre a execução de um pacote que pode ajudar a solucionar problemas de execução. Para obter mais informações sobre como gerar e configurar arquivos de despejo, consulte Generating Dump Files for Package Execution.

Para obter detalhes sobre execuções, validações, mensagens que são registradas em log durante operações, e informações contextuais relacionadas a erros, consulte estas exibições.

Você pode validar projetos e pacotes chamando os procedimentos armazenados catalog.validate_project (Banco de dados SSISDB) e catalog.validate_package (Banco de dados SSISDB). A exibição catalog.validations (Banco de dados SSISDB) fornece detalhes sobre validações, como as referências de ambiente de servidor consideradas na validação, se é uma validação de dependência ou uma validação completa e se o runtime de 32 ou 64 bits é usado para executar o pacote.

Conteúdo relacionado