Copiar dados da Greenplum utilizando a Azure Data FactoryCopy data from Greenplum using Azure Data Factory

APLICA-SE A: Azure Data Factory Azure Synapse Analytics

Este artigo descreve como utilizar a Atividade de Cópia na Fábrica de Dados Azure para copiar dados da Greenplum.This article outlines how to use the Copy Activity in Azure Data Factory to copy data from Greenplum. Baseia-se no artigo de visão geral da atividade de cópia que apresenta uma visão geral da atividade da cópia.It builds on the copy activity overview article that presents a general overview of copy activity.

Capacidades suportadasSupported capabilities

Este conector Greenplum é suportado para as seguintes atividades:This Greenplum connector is supported for the following activities:

Pode copiar dados da Greenplum para qualquer loja de dados de lavatórios suportados.You can copy data from Greenplum to any supported sink data store. Para obter uma lista de lojas de dados suportadas como fontes/pias pela atividade de cópia, consulte a tabela de lojas de dados suportadas.For a list of data stores that are supported as sources/sinks by the copy activity, see the Supported data stores table.

A Azure Data Factory fornece um controlador incorporado para permitir a conectividade, pelo que não é necessário instalar manualmente qualquer controlador utilizando este conector.Azure Data Factory provides a built-in driver to enable connectivity, therefore you don't need to manually install any driver using this connector.

Pré-requisitosPrerequisites

Se a sua loja de dados estiver localizada dentro de uma rede no local, de uma rede virtual Azure ou da Amazon Virtual Private Cloud, é necessário configurar um tempo de integração auto-hospedado para se ligar a ela.If your data store is located inside an on-premises network, an Azure virtual network, or Amazon Virtual Private Cloud, you need to configure a self-hosted integration runtime to connect to it.

Em alternativa, se a sua loja de dados for um serviço de dados em nuvem gerido, pode utilizar o tempo de execução da integração do Azure.Alternatively, if your data store is a managed cloud data service, you can use Azure integration runtime. Se o acesso for restrito aos IPs aprovados nas regras de firewall, pode adicionar IPs de Runtime de Integração Azure na lista de permitis.If the access is restricted to IPs that are approved in the firewall rules, you can add Azure Integration Runtime IPs into the allow list.

Para obter mais informações sobre os mecanismos e opções de segurança da rede suportados pela Data Factory, consulte as estratégias de acesso aos dados.For more information about the network security mechanisms and options supported by Data Factory, see Data access strategies.

IntroduçãoGetting started

Para realizar a atividade Copy com um pipeline, pode utilizar uma das seguintes ferramentas ou SDKs:To perform the Copy activity with a pipeline, you can use one of the following tools or SDKs:

As seguintes secções fornecem detalhes sobre propriedades que são usadas para definir entidades da Data Factory específicas do conector Greenplum.The following sections provide details about properties that are used to define Data Factory entities specific to Greenplum connector.

Propriedades de serviço ligadasLinked service properties

As seguintes propriedades são suportadas para o serviço ligado à Greenplum:The following properties are supported for Greenplum linked service:

PropriedadeProperty DescriçãoDescription ObrigatórioRequired
tipotype A propriedade tipo deve ser definida para: GreenplumThe type property must be set to: Greenplum YesYes
conexãoStragemconnectionString Uma cadeia de ligação ODBC para ligar ao Greenplum.An ODBC connection string to connect to Greenplum.
Também pode colocar a palavra-passe no Cofre da Chave Azure e retirar a pwd configuração da cadeia de ligação.You can also put password in Azure Key Vault and pull the pwd configuration out of the connection string. Consulte as seguintes amostras e guarde as credenciais no artigo do Azure Key Vault com mais detalhes.Refer to the following samples and Store credentials in Azure Key Vault article with more details.
YesYes
connectViaconnectVia O tempo de execução de integração a ser utilizado para ligar à loja de dados.The Integration Runtime to be used to connect to the data store. Saiba mais na secção Pré-Requisitos.Learn more from Prerequisites section. Se não for especificado, utiliza o tempo de execução de integração Azure predefinido.If not specified, it uses the default Azure Integration Runtime. NoNo

Exemplo:Example:

{
    "name": "GreenplumLinkedService",
    "properties": {
        "type": "Greenplum",
        "typeProperties": {
            "connectionString": "HOST=<server>;PORT=<port>;DB=<database>;UID=<user name>;PWD=<password>"
        },
        "connectVia": {
            "referenceName": "<name of Integration Runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

Exemplo: armazenar senha em Azure Key VaultExample: store password in Azure Key Vault

{
    "name": "GreenplumLinkedService",
    "properties": {
        "type": "Greenplum",
        "typeProperties": {
            "connectionString": "HOST=<server>;PORT=<port>;DB=<database>;UID=<user name>;",
            "pwd": { 
                "type": "AzureKeyVaultSecret", 
                "store": { 
                    "referenceName": "<Azure Key Vault linked service name>", 
                    "type": "LinkedServiceReference" 
                }, 
                "secretName": "<secretName>" 
            }
        },
        "connectVia": {
            "referenceName": "<name of Integration Runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

Dataset properties (Propriedades do conjunto de dados)Dataset properties

Para obter uma lista completa de secções e propriedades disponíveis para definir conjuntos de dados, consulte o artigo conjuntos de dados.For a full list of sections and properties available for defining datasets, see the datasets article. Esta secção fornece uma lista de propriedades suportadas pelo conjunto de dados greenplum.This section provides a list of properties supported by Greenplum dataset.

Para copiar dados da Greenplum, defina a propriedade tipo do conjunto de dados para a GreenplumTable.To copy data from Greenplum, set the type property of the dataset to GreenplumTable. As seguintes propriedades são suportadas:The following properties are supported:

PropriedadeProperty DescriçãoDescription ObrigatórioRequired
tipotype A propriedade tipo do conjunto de dados deve ser definida para: GreenplumTableThe type property of the dataset must be set to: GreenplumTable YesYes
esquemaschema O nome do esquema.Name of the schema. Não (se for especificada "consulta" na fonte de atividade)No (if "query" in activity source is specified)
tabletable O nome da mesa.Name of the table. Não (se for especificada "consulta" na fonte de atividade)No (if "query" in activity source is specified)
tableNametableName Nome da mesa com esquema.Name of the table with schema. Esta propriedade é suportada para retrocompatibilidade.This property is supported for backward compatibility. Uso schema e para nova carga de table trabalho.Use schema and table for new workload. Não (se for especificada "consulta" na fonte de atividade)No (if "query" in activity source is specified)

ExemploExample

{
    "name": "GreenplumDataset",
    "properties": {
        "type": "GreenplumTable",
        "typeProperties": {},
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<Greenplum linked service name>",
            "type": "LinkedServiceReference"
        }
    }
}

Propriedades da atividade CopyCopy activity properties

Para obter uma lista completa de secções e propriedades disponíveis para definir atividades, consulte o artigo Pipelines.For a full list of sections and properties available for defining activities, see the Pipelines article. Esta secção fornece uma lista de propriedades suportadas por fonte greenplum.This section provides a list of properties supported by Greenplum source.

GreenplumSource como fonteGreenplumSource as source

Para copiar dados da Greenplum, deslote o tipo de origem na atividade de cópia para GreenplumSource.To copy data from Greenplum, set the source type in the copy activity to GreenplumSource. As seguintes propriedades são suportadas na secção fonte de origem da atividade de cópia:The following properties are supported in the copy activity source section:

PropriedadeProperty DescriçãoDescription ObrigatórioRequired
tipotype A propriedade tipo da fonte de atividade de cópia deve ser definida para: GreenplumSourceThe type property of the copy activity source must be set to: GreenplumSource YesYes
consultaquery Utilize a consulta SQL personalizada para ler dados.Use the custom SQL query to read data. Por exemplo: "SELECT * FROM MyTable".For example: "SELECT * FROM MyTable". Não (se for especificado "tableName" no conjunto de dados)No (if "tableName" in dataset is specified)

Exemplo:Example:

"activities":[
    {
        "name": "CopyFromGreenplum",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<Greenplum input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "GreenplumSource",
                "query": "SELECT * FROM MyTable"
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

Propriedades de atividade de procuraLookup activity properties

Para obter detalhes sobre as propriedades, consulte a atividade de Lookup.To learn details about the properties, check Lookup activity.

Passos seguintesNext steps

Para obter uma lista de lojas de dados suportadas como fontes e sumidouros pela atividade de cópia na Azure Data Factory, consulte lojas de dados suportadas.For a list of data stores supported as sources and sinks by the copy activity in Azure Data Factory, see supported data stores.