Transformar dados no Planilhas Google (Visualização) usando o Azure Data Factory ou o Synapse Analytics

APLICA-SE A: Azure Data Factory Azure Synapse Analytics

Gorjeta

Experimente o Data Factory no Microsoft Fabric, uma solução de análise tudo-em-um para empresas. O Microsoft Fabric abrange tudo, desde a movimentação de dados até ciência de dados, análises em tempo real, business intelligence e relatórios. Saiba como iniciar uma nova avaliação gratuitamente!

Este artigo descreve como usar o Fluxo de Dados para transformar dados no Planilhas Google (Visualização). Para saber mais, leia o artigo introdutório do Azure Data Factory ou do Azure Synapse Analytics.

Importante

Este conector está atualmente em pré-visualização. Você pode experimentá-lo e nos dar feedback. Se quiser realizar uma dependência em conectores de pré-visualização na sua solução, contacte o Suporte do Azure.

Capacidades suportadas

Este conector do Folhas de cálculo do Google é compatível com as seguintes capacidades:

Capacidades suportadas IR
Mapeando o fluxo de dados (fonte/-)

(1) Tempo de execução de integração do Azure (2) Tempo de execução de integração auto-hospedado

Para obter uma lista de armazenamentos de dados suportados como fontes/coletores, consulte a tabela Armazenamentos de dados suportados.

Criar um serviço vinculado do Planilhas Google usando a interface do usuário

Use as etapas a seguir para criar um serviço vinculado do Planilhas Google na interface do usuário do portal do Azure.

  1. Navegue até a guia Gerenciar em seu espaço de trabalho do Azure Data Factory ou Synapse e selecione Serviços Vinculados e, em seguida, selecione Novo:

  2. Pesquise por Planilhas Google (Visualização) e selecione o conector Planilhas Google (Visualização).

    Screenshot showing selecting Google Sheets connector.

  3. Configure os detalhes do serviço, teste a conexão e crie o novo serviço vinculado.

    Screenshot of configuration for Google Sheets linked service.

Detalhes de configuração do conector

As seções a seguir fornecem informações sobre propriedades usadas para definir entidades de pipeline do Data Factory e do Synapse específicas do Planilhas Google.

Propriedades do serviço vinculado

As seguintes propriedades são compatíveis com o serviço vinculado do Planilhas Google:

Propriedade Descrição Necessário
tipo A propriedade type deve ser definida como GoogleSheets. Sim
apiToken Especifique um token de API para o Planilhas Google. Marque este campo como SecureString para armazená-lo com segurança. Ou, você pode fazer referência a um segredo armazenado no Cofre da Chave do Azure. Sim

Exemplo:

{
    "name": "GoogleSheetsLinkedService",
    "properties": {
        "type": "GoogleSheets",
        "typeProperties": {
            "apiToken": {
                "type": "SecureString",
                "value": "<API token>"
            }
        }
    }
}

Mapeando propriedades de fluxo de dados

Ao transformar dados em fluxo de dados de mapeamento, você pode ler recursos do Planilhas Google. Para obter mais informações, consulte a transformação de origem no mapeamento de fluxos de dados. Você só pode usar um conjunto de dados embutido como tipo de origem.

Transformação da fonte

A tabela abaixo lista as propriedades suportadas pela fonte do Planilhas Google. Você pode editar essas propriedades na guia Opções de origem .

Nome Descrição Necessário Valores permitidos Propriedade do script de fluxo de dados
SpreadSheet ID O ID da planilha no Planilhas Google. Verifique se o acesso geral da planilha está definido como Qualquer pessoa com o link. Sim String spreadSheetId
Nome da folha O nome da planilha na planilha. Sim String Nome da folha
Célula inicial A célula inicial da folha de onde os dados são necessários, por exemplo A2, B4. Sim String startCell [en]
Célula final A célula final da folha até onde os dados são necessários, por exemplo F10, S600. Sim String endCell

Exemplo de script de origem do Planilhas Google

Quando você usa o Planilhas Google como tipo de fonte, o script de fluxo de dados associado é:

source(allowSchemaDrift: true,
	validateSchema: false,
	store: 'googlesheets',
	format: 'rest',
	spreadSheetId: $spreadSheetId,
	startCell: 'A2',
	endCell: 'F10',
	sheetName: 'Sheet1') ~> GoogleSheetsSource

Para obter uma lista de armazenamentos de dados suportados como fontes e coletores pela atividade de cópia, consulte Armazenamentos de dados suportados.