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 destino OLE DB carrega dados em uma variedade de bancos de dados compatíveis com OLE DB usando uma tabela ou exibição de banco de dados ou um comando SQL. Por exemplo, a fonte OLE DB pode carregar dados em tabelas em bancos de dados do Microsoft Office Access e do SQL Server.
Observação
Se a fonte de dados for o Microsoft Office Excel 2007, a fonte de dados exigirá um gerenciador de conexões diferente das versões anteriores do Excel. Para obter mais informações, consulte Conectar-se a uma pasta de trabalho do Excel.
O destino OLE DB fornece cinco modos diferentes de acesso a dados para carregar dados:
Uma tabela ou vista. Você pode especificar uma tabela ou exibição existente ou criar uma nova tabela.
Uma tabela ou exibição usando opções de carregamento rápido. Você pode especificar uma tabela existente ou criar uma nova tabela.
Uma tabela ou exibição especificada em uma variável.
Uma tabela ou exibição especificada em uma variável usando opções de carregamento rápido.
Os resultados de uma instrução SQL.
Observação
O destino OLE DB não suporta parâmetros. Se você precisar executar uma instrução INSERT parametrizada, considere a transformação do comando OLE DB. Para obter mais informações, consulte Transformação de comando OLE DB.
Quando o destino OLE DB carrega dados que usa um conjunto de caracteres de byte duplo (DBCS), os dados podem ser corrompidos se o modo de acesso a dados não usar a opção de carregamento rápido e se o gerenciador de conexões OLE DB usa o Microsoft OLE DB Provider for SQL Server (SQLOLEDB). Para garantir a integridade dos dados DBCS, você deve configurar o gerenciador de conexões OLE DB para usar o SQL Server Native Client ou usar um dos modos de acesso de carga rápida: Tabela ou exibição - carregamento rápido ou Nome da tabela ou variável de nome de exibição - carregamento rápido. Ambas as opções estão disponíveis na caixa de diálogo Editor de destino OLE DB . Ao programar o modelo de objeto SSIS, você deve definir a propriedade AccessMode como OpenRowset Usando FastLoad ou OpenRowset Usando FastLoad From Variable.
Observação
Se você usar a caixa de diálogo Editor de Destino OLE DB no Designer SSIS para criar a tabela de destino na qual o destino OLE DB insere dados, talvez seja necessário selecionar a tabela recém-criada manualmente. A necessidade de seleção manual ocorre quando um provedor OLE DB, como o provedor OLE DB para DB2, adiciona automaticamente identificadores de esquema ao nome da tabela.
Observação
A instrução CREATE TABLE que a caixa de diálogo Editor de destino OLE DB gera pode exigir modificação, dependendo do tipo de destino. Por exemplo, alguns destinos não suportam os tipos de dados que a instrução CREATE TABLE usa.
Esse destino usa um gerenciador de conexões OLE DB para se conectar a uma fonte de dados e o gerenciador de conexões especifica o provedor OLE DB a ser usado. Para obter mais informações, consulte Gerenciador de conexões OLE DB.
Um projeto do Integration Services também fornece o objeto de fonte de dados a partir do qual você pode criar um gerenciador de conexões OLE DB, para disponibilizar fontes de dados e exibições de fonte de dados para o destino OLE DB.
Um destino OLE DB inclui mapeamentos entre colunas de entrada e colunas na fonte de dados de destino. Não é necessário mapear colunas de entrada para todas as colunas de destino, mas, dependendo das propriedades das colunas de destino, podem ocorrer erros se nenhuma coluna de entrada for mapeada para as colunas de destino. Por exemplo, se uma coluna de destino não permitir valores nulos, uma coluna de entrada deverá ser mapeada para essa coluna. Além disso, os tipos de dados das colunas mapeadas devem ser compatíveis. Por exemplo, não é possível mapear uma coluna de entrada com um tipo de dados de cadeia de caracteres para uma coluna de destino com um tipo de dados numérico.
O destino OLE DB tem uma entrada regular e uma saída de erro.
Para obter mais informações sobre tipos de dados, consulte Tipos de dados do Integration Services.
Opções de carregamento rápido
Se o destino OLE DB usar um modo de acesso a dados de carga rápida, você poderá especificar as seguintes opções de carregamento rápido na interface do usuário, Editor de destino OLE DB, para o destino:
Mantenha valores de identidade do arquivo de dados importado ou use valores exclusivos atribuídos pelo SQL Server.
Retenha um valor nulo durante a operação de carga em massa.
Verifique as restrições na tabela ou exibição de destino durante a operação de importação em massa.
Adquira um bloqueio no nível da tabela durante a operação de carga em massa.
Especifique o número de linhas no lote e o tamanho do commit.
Algumas opções de carregamento rápido são armazenadas em propriedades específicas do destino OLE DB. Por exemplo, FastLoadKeepIdentity especifica se os valores de identificação devem ser mantidos, FastLoadKeepNulls especifica se os valores nulos devem ser mantidos e FastLoadMaxInsertCommitSize especifica o número de linhas a serem confirmadas como um lote. Outras opções de carregamento rápido são armazenadas em uma lista separada por vírgulas na propriedade FastLoadOptions. Se o destino OLE DB usar todas as opções de carregamento rápido armazenadas em FastLoadOptions e listadas na caixa de diálogo Editor de destino OLE DB , o valor da propriedade será definido como TABLOCK, CHECK_CONSTRAINTS, ROWS_PER_BATCH=1000. O valor 1000 indica que o destino está configurado para usar lotes de 1000 linhas.
Observação
Qualquer falha de restrição no destino faz com que todo o lote de linhas definido por FastLoadMaxInsertCommitSize falhe.
Além das opções de carregamento rápido expostas na caixa de diálogo Editor de destino OLE DB , você pode configurar o destino OLE DB para usar as seguintes opções de carregamento em massa digitando as opções na propriedade FastLoadOptions na caixa de diálogo Editor Avançado .
| Opção de carregamento rápido | Descrição |
|---|---|
| KILOBYTES_POR_BATCH | Especifica o tamanho em kilobytes a ser inserido. A opção tem a forma KILOBYTES_PER_BATCH = <valor> inteiro positivo. |
| DISPARADORES_DE_FOGO | Especifica se os gatilhos são acionados na tabela de inserção. A opção tem a forma FIRE_TRIGGERS. A presença da opção indica que aciona o fogo. |
| ENCOMENDA | Especifica como os dados de entrada são classificados. A opção tem o formato ORDER <nome da coluna> ASC|DESC. Qualquer número de colunas pode ser listado e é opcional incluir a ordem de classificação. Se a ordem de classificação for omitida, a operação de inserção assumirá que os dados não estão classificados. Nota: O desempenho pode ser melhorado se você usar a opção ORDER para classificar os dados de entrada de acordo com o índice clusterizado na tabela. |
As palavras-chave Transact-SQL são tradicionalmente escritas em maiúsculas, embora não façam distinção entre maiúsculas e minúsculas.
Para saber mais sobre as opções de carregamento rápido, consulte BULK INSERT (Transact-SQL).
Solução de problemas do destino OLE DB
Você pode registrar as chamadas que o destino OLE DB faz para provedores de dados externos. Você pode usar esse recurso de log para solucionar problemas de salvamento de dados em fontes de dados externas que o destino OLE DB executa. Para registrar as chamadas que o destino OLE DB faz para provedores de dados externos, habilite o log de pacotes e selecione o evento de diagnóstico no nível do pacote. Para obter mais informações, consulte Ferramentas de solução de problemas para execução de pacotes.
Configurando o destino OLE DB
Você pode definir propriedades por meio do SSIS Designer ou programaticamente.
A caixa de diálogo Advanced Editor reflete as propriedades que podem ser definidas programaticamente. Para obter mais informações sobre as propriedades que você pode definir na caixa de diálogo Advanced Editor ou programaticamente, clique em um dos seguintes tópicos:
Para obter mais informações sobre como definir propriedades, clique em um dos seguintes tópicos:
Editor de destino OLE DB (página Gerenciador de conexões)
Use a página Gerenciador de Conexões da caixa de diálogo Editor de Destino OLE DB para selecionar a conexão OLE DB para o destino. Esta página também permite selecionar uma tabela ou exibição do banco de dados.
Observação
Se a fonte de dados for o Microsoft Office Excel 2007, a fonte de dados exigirá um gerenciador de conexões diferente das versões anteriores do Excel. Para obter mais informações, consulte Conectar-se a uma pasta de trabalho do Excel.
Observação
A propriedade CommandTimeout do destino OLE DB não está disponível no Editor de destino OLE DB, mas pode ser definida usando o Editor Avançado. Além disso, certas opções de carregamento rápido estão disponíveis apenas no Editor Avançado. Para obter mais informações sobre essas propriedades, consulte a seção Destino do OLE DB das Propriedades personalizadas do OLE DB.
A propriedade CommandTimeout só entra em vigor quando o modo de acesso a dados é o comando SQL.
Opções estáticas
Gerenciador de conexões OLE DB
Selecione um gerenciador de conexões existente na lista ou crie uma nova conexão clicando em Novo.
Novo
Crie um novo gerenciador de conexões usando a caixa de diálogo Configurar Gerenciador de Conexões OLE DB .
Modo de acesso aos dados
Especifique o método para carregar dados no destino. O carregamento de dados DBCS (conjunto de caracteres de byte duplo) requer o uso de uma das opções de carregamento rápido. Para obter mais informações sobre os modos de acesso a dados de carregamento rápido, que são otimizados para inserções em massa, consulte Destino do OLE DB.
| Opção | Descrição |
|---|---|
| Tabela ou vista | Carregue dados numa tabela ou vista no destino OLE DB. |
| Tabela ou vista - carregamento rápido | Carregue dados em uma tabela ou exibição no destino OLE DB e use a opção de carregamento rápido. Para obter mais informações sobre os modos de acesso a dados de carregamento rápido, que são otimizados para inserções em massa, consulte Destino do OLE DB. |
| Nome da tabela ou variável de nome de exibição | Especifique o nome da tabela ou exibição em uma variável. Informações relacionadas: Usar variáveis em pacotes |
| Nome da tabela ou variável de nome de exibição - carregamento rápido | Especifique o nome da tabela ou exibição em uma variável e use a opção de carregamento rápido para carregar os dados. Para obter mais informações sobre os modos de acesso a dados de carregamento rápido, que são otimizados para inserções em massa, consulte Destino do OLE DB. |
| Comando SQL | Carregue dados no destino OLE DB usando uma consulta SQL. |
Previsualizar
Visualize os resultados usando a caixa de diálogo Visualizar Resultados da Consulta . A pré-visualização pode apresentar até 200 linhas.
Opções dinâmicas do modo de acesso a dados
Cada uma das configurações do modo de acesso a dados exibe um conjunto dinâmico de opções específicas para essa configuração. As seções a seguir descrevem cada uma das opções dinâmicas disponíveis para cada configuração do modo de acesso a dados .
Modo de acesso a dados = Tabela ou vista
Nome da tabela ou da vista
Selecione o nome da tabela ou exibição em uma lista das disponíveis na fonte de dados.
Novo
Crie uma nova tabela usando a caixa de diálogo Criar tabela .
Observação
Quando você clica em Novo, o Integration Services gera uma instrução CREATE TABLE padrão com base na fonte de dados conectada. Esta instrução CREATE TABLE padrão não incluirá o atributo FILESTREAM, mesmo que a tabela de origem inclua uma coluna com o atributo FILESTREAM declarado. Para executar um componente do Integration Services com o atributo FILESTREAM, primeiro implemente o armazenamento FILESTREAM no banco de dados de destino. Em seguida, adicione o atributo FILESTREAM à instrução CREATE TABLE na caixa de diálogo Criar tabela . Para obter mais informações, consulte Dados de objeto binário grande (Blob) (SQL Server).
Modo de acesso a dados = Tabela ou visualização - carregamento rápido
Nome da tabela ou vista
Selecione uma tabela ou exibição do banco de dados usando essa lista ou crie uma nova tabela clicando em Novo.
Novo
Crie uma nova tabela usando a caixa de diálogo Criar tabela .
Observação
Quando você clica em Novo, o Integration Services gera uma instrução CREATE TABLE padrão com base na fonte de dados conectada. Esta instrução CREATE TABLE padrão não incluirá o atributo FILESTREAM, mesmo que a tabela de origem inclua uma coluna com o atributo FILESTREAM declarado. Para executar um componente do Integration Services com o atributo FILESTREAM, primeiro implemente o armazenamento FILESTREAM no banco de dados de destino. Em seguida, adicione o atributo FILESTREAM à instrução CREATE TABLE na caixa de diálogo Criar tabela . Para obter mais informações, consulte Dados de objeto binário grande (Blob) (SQL Server).
Manter a identidade
Especifique se os valores de identidade devem ser copiados quando os dados forem carregados. Esta propriedade está disponível apenas com a opção de carregamento rápido. O valor padrão dessa propriedade é false.
Manter nulos
Especifique se deseja copiar valores nulos quando os dados forem carregados. Esta propriedade está disponível apenas com a opção de carregamento rápido. O valor padrão dessa propriedade é false.
Bloqueio de tabela
Indique se a tabela está bloqueada durante o processo de carregamento. O valor padrão dessa propriedade é true.
Verificar restrições
Especifique se o destino verifica restrições quando carrega dados. O valor padrão dessa propriedade é true.
Linhas por lote
Especifique o número de linhas em um lote. O valor padrão dessa propriedade é -1, o que indica que nenhum valor foi atribuído.
Observação
Desmarque a caixa de texto no Editor de destino do OLE DB para indicar que você não deseja atribuir um valor personalizado para essa propriedade.
Tamanho máximo de confirmação de inserção
Especifique o tamanho do lote que o destino OLE DB tenta confirmar durante operações de carregamento rápido. O valor 0 indica que todos os dados são confirmados em um único lote depois que todas as linhas foram processadas.
Observação
Um valor 0 pode fazer com que o pacote em execução pare de responder se o destino OLE DB e outro componente de fluxo de dados estiverem atualizando a mesma tabela de origem. Para evitar que o pacote pare, defina a opção Tamanho máximo de confirmação de inserção como 2147483647.
Se você fornecer um valor para essa propriedade, o destino confirmará linhas em lotes que são o menor de (a) o tamanho máximo de confirmação de inserção ou (b) as linhas restantes no buffer que está sendo processado no momento.
Observação
Qualquer falha de restrição no destino faz com que todo o lote de linhas definido pelo tamanho máximo de confirmação de inserção falhe.
Modo de acesso a dados = Nome da tabela ou variável de nome de exibição
Nome da variável
Selecione a variável que contém o nome da tabela ou exibição.
Modo de Acesso a Dados = Nome da tabela ou variável de nome de exibição - carregamento rápido)
Nome da variável
Selecione a variável que contém o nome da tabela ou exibição.
Novo
Crie uma nova tabela usando a caixa de diálogo Criar tabela .
Observação
Quando você clica em Novo, o Integration Services gera uma instrução CREATE TABLE padrão com base na fonte de dados conectada. Esta instrução CREATE TABLE padrão não incluirá o atributo FILESTREAM, mesmo que a tabela de origem inclua uma coluna com o atributo FILESTREAM declarado. Para executar um componente do Integration Services com o atributo FILESTREAM, primeiro implemente o armazenamento FILESTREAM no banco de dados de destino. Em seguida, adicione o atributo FILESTREAM à instrução CREATE TABLE na caixa de diálogo Criar tabela . Para obter mais informações, consulte Dados de objeto binário grande (Blob) (SQL Server).
Manter a identidade
Especifique se os valores de identidade devem ser copiados quando os dados forem carregados. Esta propriedade está disponível apenas com a opção de carregamento rápido. O valor padrão dessa propriedade é false.
Manter nulos
Especifique se deseja copiar valores nulos quando os dados forem carregados. Esta propriedade está disponível apenas com a opção de carregamento rápido. O valor padrão dessa propriedade é false.
Bloqueio de tabela
Indique se a tabela está bloqueada durante o processo de carregamento. O valor padrão dessa propriedade é false.
Verificar restrições
Especifique se a tarefa verifica as restrições. O valor padrão dessa propriedade é false.
Linhas por lote
Especifique o número de linhas em um lote. O valor padrão dessa propriedade é -1, o que indica que nenhum valor foi atribuído.
Observação
Desmarque a caixa de texto no Editor de destino do OLE DB para indicar que você não deseja atribuir um valor personalizado para essa propriedade.
Tamanho máximo de confirmação de inserção
Especifique o tamanho do lote que o destino OLE DB tenta confirmar durante operações de carregamento rápido. O valor padrão de 2147483647 indica que todos os dados são confirmados em um único lote depois que todas as linhas foram processadas.
Observação
Um valor 0 pode fazer com que o pacote em execução pare de responder se o destino OLE DB e outro componente de fluxo de dados estiverem atualizando a mesma tabela de origem. Para evitar que o pacote pare, defina a opção Tamanho máximo de confirmação de inserção como 2147483647.
Modo de acesso a dados = comando SQL
Texto do comando SQL
Insira o texto de uma consulta SQL, crie a consulta clicando em Criar Consulta ou localize o arquivo que contém o texto da consulta clicando em Procurar.
Observação
O destino OLE DB não suporta parâmetros. Se você precisar executar uma instrução INSERT parametrizada, considere a transformação do comando OLE DB. Para obter mais informações, consulte Transformação de comando OLE DB.
Construir consulta
Use a caixa de diálogo Construtor de Consultas para construir a consulta SQL visualmente.
Navegar
Use a caixa de diálogo Abrir para localizar o arquivo que contém o texto da consulta SQL.
Analisar consulta
Verifique a sintaxe do texto da consulta.
Editor de Destino OLE DB (Página Mapeamentos)
Use a página Mapeamentos da caixa de diálogo Editor de destino OLE DB para mapear colunas de entrada para colunas de destino.
Opções
Colunas de entrada disponíveis
Veja a lista de colunas de entrada disponíveis. Use uma operação de arrastar e soltar para mapear as colunas de entrada disponíveis na tabela para as colunas de destino.
Colunas de destino disponíveis
Veja a lista de colunas de destino disponíveis. Use uma operação de arrastar e soltar para mapear colunas de destino disponíveis na tabela para colunas de entrada.
Coluna de Entrada
Exiba as colunas de entrada selecionadas. Você pode remover mapeamentos selecionando <ignorar> excluir colunas da saída.
Coluna de destino
Visualize cada coluna de destino disponível, independentemente de estar mapeada ou não.
Editor de destino OLE DB (página de saída de erro)
Use a página Saída de Erro da caixa de diálogo Editor de Destino OLE DB para especificar opções de tratamento de erros.
Opções
de entrada/saída
Exiba o nome da entrada.
Coluna
Não utilizado.
Erro
Especifique o que deve acontecer quando ocorrer um erro: ignore a falha, redirecione a linha ou falhe o componente.
Tópicos relacionados:Tratamento de erros em dados
Truncamento
Não utilizado.
Descrição
Veja a descrição da operação.
Defina esse valor para células selecionadas
Especifique o que deve acontecer com todas as células selecionadas quando ocorrer um erro ou truncamento: ignore a falha, redirecione a linha ou falhe o componente.
Candidatar-se
Aplique a opção de tratamento de erros às células selecionadas.