Tutorial: Usando a fonte OData

Aplica-se a: SQL Server SSIS Integration Runtime em Azure Data Factory

Este tutorial guia-o pelo processo para extrair a coleção Employees do serviço Northwind OData de exemplo (https://services.odata.org/V3/Northwind/Northwind.svc/), e depois carregá-la num ficheiro plano.

1. Criar um projeto de Serviços de Integração

1. Inicie o SQL Server Data Tools ou o Visual Studio.

2. Clica em Ficheiro, aponta para Novo e clica em Project.

3. Na caixa de diálogo New Project, expanda Instalado, expanda Templates, expanda Business Intelligence e clique em Serviços de Integração.

4. Selecione Integration Services Project como tipo de projeto.

5. Introduza um nome e selecione uma localização para o projeto, e clique em OK.

2. Adicionar e configurar uma Fonte OData

1. Arraste uma tarefa Fluxo de Dados da SSIS Toolbox para a superfície de design do fluxo de controlo do teu pacote SSIS.

2. Clique no separador Fluxo de Dados ou clique duas vezes na tarefa Fluxo de Dados para abrir a superfície de design do Fluxo de Dados.

3. Arraste e largue Origem OData do grupo Comum da Caixa de Ferramentas do SSIS.

4. Clique duas vezes no componente OData Source para abrir a caixa de diálogo OData Source Editor .

5. Clique em Novo... para adicionar um novo Gestor de Ligações OData.

6. Introduza a URL do serviço OData para a localização do documento de serviço. Este URL pode ser o URL para o documento de serviço, ou para um feed ou entidade específica. Para efeitos deste tutorial, introduza a URL do documento de serviço: https://services.odata.org/V3/Northwind/Northwind.svc/.

7. Confirme que a Autenticação Windows está selecionada como a autenticação a utilizar para aceder ao serviço OData. A autenticação do Windows está selecionada por defeito.

8. Clica em Testar Ligação para testar a ligação e clica em OK para terminar de criar uma instância do OData Gestor de Ligações.

9. Na caixa de diálogo Editor de Fonte OData, confirme que Coleção está selecionado para a opção Utilizar coleção no caminho do recurso.

10. Na lista pendente Coleção, selecione Colaboradores.

11. Insira quaisquer opções ou filtros adicionais de consulta OData para Opções de Consulta. Por exemplo, $orderby=CompanyName&$top=100. Para efeitos deste tutorial, introduza $top=5.

12. Clique em Pré-visualização para visualizar os dados.

13. Clique em Colunas no painel de navegação esquerdo para ir para a página Colunas.

14. Selecione EmployeeID, Primeiro Nome e Apelido nas Colunas Externas Disponíveis assinalando as caixas.

15. Clique em OK para fechar a caixa de diálogo do Editor de Código Fonte do OData .

3. Adicionar e configurar um Destino de Ficheiro Plano

1. Agora, arraste e largue um Flat File Destination da SSIS Toolbox para a superfície de estrutura do Fluxo de Dados, por baixo do componente OData Source.

2. Ligue o componente OData Source ao componente Flat File Destination utilizando a seta azul.

3. Faça duplo clique em Destino de Ficheiro Plano. Deves ver a caixa de diálogo Editor de Destino de Ficheiros Planos .

4. Na caixa de diálogo Editor de Destino de Ficheiros Planos , clique em Novo para criar um novo gestor de ligação de ficheiros planos.

5. Na caixa de diálogo Flat File Format , selecione Delimitado. Em seguida, vê a caixa de diálogo Editor do Gestor de Ligações de Ficheiro Simples.

6. Na caixa de diálogo Flat File Gestor de Ligações Editor, para o nome do ficheiro, introduza c:\Employees.txt.

7. No painel de navegação à esquerda, clique em Colunas. Pode pré-visualizar os dados nesta página.

8. Clique em OK para fechar a caixa de diálogo do Editor do Gestor de Ligações de Ficheiros Simples.

9. Na caixa de diálogo Editor de Destino de Ficheiros Planos , clique em Mapeamentos no painel de navegação esquerdo. Revê os mapeamentos.

10. Clique em OK para fechar a caixa de diálogo do Editor de Destino de Ficheiro Plano .

4. Executar o pacote

Executa o pacote SSIS. Verifique se o ficheiro de saída foi criado com ID, Primeiro Nome e Apelido para cinco funcionários a partir do feed OData.