Fonte Oracle
se aplica a:
SQL Server SSIS Integration Runtime no Azure Data Factory
Importante
O Microsoft Connector for Oracle foi preterido agora. Os detalhes referem-se a o anúncio.
A fonte Oracle extrai dados do Oracle Database com os seguintes modos:
Uma tabela ou vista.
Os resultados de uma instrução SQL.
A origem usa um Oracle Connection Manager para se conectar à fonte Oracle. Para obter mais informações, consulte Oracle Connection Manager.
Saída de erro
A saída de erro inclui as seguintes colunas:
Código de erro: um número que representa o tipo de erro do erro atual. O código de erro pode ser de:
- Servidor Oracle. Consulte a descrição detalhada do erro na documentação do banco de dados Oracle.
- Tempo de execução do SSIS. Para obter uma lista de códigos de erro SSIS, consulte Código de erro SSIS e Referência de mensagem.
Coluna de erro: O número da coluna de origem que causa os erros de conversão.
Colunas de dados de erro: Os dados que causam o erro.
A origem Oracle retorna erros ocorridos durante o processo de carregamento e extração na saída do erro. Para obter mais informações, consulte Oracle Source Editor (Error Output Page).
Solução de problemas na origem do Oracle
Você pode registrar as chamadas ODBC que a fonte Oracle faz para fontes de dados Oracle para solucionar problemas de exportação de dados. Para registrar as chamadas ODBC que a fonte Oracle faz para fontes de dados Oracle, habilite o rastreamento do gerenciador de driver ODBC. Para obter mais informações, consulte a documentação da Microsoft sobre como gerar um rastreamento ODBC com ODBC o administrador da fonte de dados.
Propriedades personalizadas de origem Oracle
As propriedades personalizadas da fonte Oracle são as seguintes. Todas as propriedades são de leitura/gravação.
| Nome da propriedade | Tipo de dados | Descrição |
|---|---|---|
| AccessMode | Inteiro (enumeração) | O modo usado para acessar o banco de dados. Os valores possíveis são de Nome da Tabela e Comando SQL. O padrão é Nome da Tabela. |
| Tamanho do lote | Inteiro | O tamanho do lote para carregamento a granel. Este é o número de registros extraídos como uma matriz. Esta propriedade é definida apenas por Editor Avançado |
| DefaultCodePage | Inteiro | A página de código a ser usada quando a fonte de dados não tiver informações de página de código. Esta propriedade é definida apenas por Editor Avançado. |
| PreFetchCount | Inteiro | O número de linhas pré-buscadas. Esta propriedade é definida apenas por Editor Avançado. |
| SqlCommand | String | O comando SQL a ser executado quando AccessMode é definido como SQL Command. |
| Nome da tabela | String | O nome da tabela com os dados a serem usados quando AccessMode é definido como Nome da Tabela. |
Configurando a origem do Oracle
Você pode configurar o código-fonte Oracle programaticamente ou por meio do SSIS Designer.
O Oracle Source Editor é mostrado na imagem abaixo. Ele contém Página do Gerenciador de Conexões, Página de Colunas e Página de Saída de Erro.
Para obter mais informações, consulte uma das seguintes seções:
- Oracle Source Editor (página do Connection Manager)
- Oracle Source Editor (página Colunas)
- Oracle Source Editor (página de saída de erro)
de origem Oracle
A caixa de diálogo Editor Avançado contém as propriedades que podem ser definidas programaticamente.
Para abrir a caixa de diálogo Advanced Editor:
- Na tela
Fluxo de Dados do seu projeto do Integration Services, clique com o botão direito do mouse na fonte Oracle e selecione Mostrar Editor Avançado .
Para obter mais informações sobre as propriedades que você pode definir na caixa de diálogo Advanced Editor, consulte Oracle Source Custom Properties.
Oracle Source Editor (página Gerenciador de Conexões)
Na página
Para abrir a página do Oracle Source Editor Connection Manager
No SQL Server Data Tools, abra o pacote do SQL Server Integration Services (SSIS) que tem a origem Oracle.
Na guia Fluxo de Dados, clique duas vezes na fonte Oracle.
Opções
Gerenciador de conexões
Selecione um gerenciador de conexões existente na lista ou clique em Novo para criar um novo gerenciador de conexões Oracle.
Nova
Clique Novo. A caixa de diálogo Oracle Connection Manager Editor é aberta, onde você pode criar um novo gerenciador de conexões.
Modo de Acesso a Dados
Selecione o método para selecionar dados da fonte. As opções são mostradas na tabela a seguir:
| Opção | Descrição |
|---|---|
| Tabela ou vista | Recupere dados de uma tabela ou exibição na fonte de dados Oracle. Quando esta opção estiver selecionada, selecione uma tabela ou vista disponível na lista para Nome da tabela ou da vista. |
| Comando SQL | Recupere dados da fonte de dados Oracle usando uma consulta SQL. Quando esta opção estiver selecionada, introduza uma consulta de uma das seguintes formas: Insira o texto da consulta SQL no campo de texto do comando Clique em Procurar para carregar a consulta SQL de um arquivo de texto. Clique de consulta Analisar para verificar a sintaxe do texto da consulta. |
Pré-visualização
Clique de Pré-visualização para ver até às primeiras 200 linhas dos dados extraídos da tabela ou vista selecionada.
Editor de código-fonte Oracle (página Colunas)
Na página
Para abrir a página Colunas do Oracle Source Editor
No SQL Server Data Tools, abra o pacote do SQL Server Integration Services (SSIS) que tem a origem Oracle.
Na guia Fluxo de Dados, clique duas vezes na fonte Oracle.
No Oracle Source Editor, clique em Colunas.
Opções
Colunas externas disponíveis
Uma lista de colunas externas disponíveis que podem ser selecionadas para adicionar à lista de de Coluna Externa na ordem em que são selecionadas. Esta tabela não pode ser usada para adicionar ou excluir colunas.
Marque a caixa de seleção Selecionar todos os para selecionar todas as colunas.
Colunas externas
As colunas externas (origem) selecionadas são listadas em ordem. Para alterar a ordem, primeiro desmarque a lista **Coluna externa disponível" e, em seguida, selecione a(s) coluna(s) com uma ordem diferente.
Coluna de saída
O nome da coluna externa (origem) selecionada é o nome de saída padrão. Embora você possa inserir qualquer nome exclusivo.
Observação
Se houver colunas com tipos de dados sem suporte, haverá um aviso mostrando que os tipos de dados não são suportados e as colunas relacionadas serão removidas das colunas de mapeamento.
Oracle Source Editor (página de saída de erro)
Use a página de saída de erro
Para abrir a página de saída de erro do Oracle Source Editor
No SQL Server Data Tools, abra o pacote do SQL Server Integration Services (SSIS) que tem a origem Oracle.
Na guia Fluxo de Dados, clique duas vezes na fonte Oracle.
No Oracle Source Editor, clique em Error Output (Saída de erro).
Opções
Comportamento de erro
Selecione como a origem Oracle deve lidar com erros em um fluxo: ignore a falha, redirecione a linha ou falhe o componente. Seção relacionada: Tratamento de erros de no de dados
Truncamento
Selecione como a origem Oracle deve lidar com o truncamento em um fluxo: ignore a falha, redirecione a linha ou falhe o componente.
Próximos passos
- Configure Oracle Destination.
- Em caso de dúvidas, visite TechCommunity.