Copiar dados do Google AdWords usando o Azure Data FactoryCopy data from Google AdWords using Azure Data Factory
Azure Data Factory
Azure Synapse Analytics
Este artigo descreve como usar a atividade de cópia no Azure Data Factory para copiar dados do Google AdWords.This article outlines how to use the Copy Activity in Azure Data Factory to copy data from Google AdWords. Ele amplia o artigo Visão geral da atividade de cópia que apresenta uma visão geral da atividade de cópia.It builds on the copy activity overview article that presents a general overview of copy activity.
Funcionalidades com suporteSupported capabilities
Este conector do Google AdWords tem suporte para as seguintes atividades:This Google AdWords connector is supported for the following activities:
- Atividade de cópia com matriz de fonte/coletor com suporteCopy activity with supported source/sink matrix
- Atividade de pesquisaLookup activity
Você pode copiar dados de um Google AdWords para qualquer armazenamento de dados de coletor compatível.You can copy data from Google AdWords to any supported sink data store. Para obter uma lista de armazenamentos de dados com suporte como origens/coletores da atividade de cópia, confira a tabela Armazenamentos de dados com suporte.For a list of data stores that are supported as sources/sinks by the copy activity, see the Supported data stores table.
Azure Data Factory fornece um driver interno para habilitar a conectividade, portanto, não é necessário instalar manualmente qualquer driver usando esse 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.
IntroduçãoGetting started
Para executar a atividade de Cópia com um pipeline, será possível usar as ferramentas ou os SDKs abaixo:To perform the Copy activity with a pipeline, you can use one of the following tools or SDKs:
- A ferramenta Copiar DadosThe Copy Data tool
- O portal do AzureThe Azure portal
- O SDK do .NETThe .NET SDK
- O SDK do PythonThe Python SDK
- PowerShell do AzureAzure PowerShell
- A API RESTThe REST API
- O modelo do Azure Resource ManagerThe Azure Resource Manager template
As seções que se seguem fornecem detalhes sobre as propriedades que são usadas para definir entidades do Data Factory específicas ao conector do Google AdWords.The following sections provide details about properties that are used to define Data Factory entities specific to Google AdWords connector.
Propriedades do serviço vinculadoLinked service properties
As propriedades a seguir são compatíveis com o serviço vinculado do Google AdWords:The following properties are supported for Google AdWords linked service:
PropriedadeProperty | DescriçãoDescription | ObrigatórioRequired |
---|---|---|
typetype | A propriedade type deve ser definida como GoogleAdWordsThe type property must be set to: GoogleAdWords | SimYes |
clientCustomerIDclientCustomerID | A ID do cliente da conta do AdWords para a qual você deseja buscar dados do relatório.The Client customer ID of the AdWords account that you want to fetch report data for. | SimYes |
developerTokendeveloperToken | O token de desenvolvedor associado à conta de gerenciador que você usa para permitir acesso à API do AdWords.The developer token associated with the manager account that you use to grant access to the AdWords API. Você pode optar por marcar este campo como uma SecureString para armazená-la com segurança no ADF ou então armazenar a senha no Azure Key Vault e permitir que o ADF copie o pull de atividade desse local ao executar a cópia de dados – saiba mais sobre como Armazenar credenciais no Key Vault.You can choose to mark this field as a SecureString to store it securely in ADF, or store password in Azure Key Vault and let ADF copy activity pull from there when performing data copy - learn more from Store credentials in Key Vault. | SimYes |
authenticationTypeauthenticationType | O mecanismo de autenticação OAuth 2.0 usado para autenticação.The OAuth 2.0 authentication mechanism used for authentication. ServiceAuthentication só pode ser usado em IR auto-hospedado.ServiceAuthentication can only be used on self-hosted IR. Os valores permitidos são: ServiceAuthentication, UserAuthenticationAllowed values are: ServiceAuthentication, UserAuthentication |
SimYes |
refreshTokenrefreshToken | O token de atualização obtido do Google para autorizar o acesso ao AdWords para UserAuthentication.The refresh token obtained from Google for authorizing access to AdWords for UserAuthentication. Você pode optar por marcar este campo como uma SecureString para armazená-la com segurança no ADF ou então armazenar a senha no Azure Key Vault e permitir que o ADF copie o pull de atividade desse local ao executar a cópia de dados – saiba mais sobre como Armazenar credenciais no Key Vault.You can choose to mark this field as a SecureString to store it securely in ADF, or store password in Azure Key Vault and let ADF copy activity pull from there when performing data copy - learn more from Store credentials in Key Vault. | NãoNo |
clientIdclientId | A ID do cliente do aplicativo Google usado para adquirir o token de atualização.The client ID of the Google application used to acquire the refresh token. Você pode optar por marcar este campo como uma SecureString para armazená-la com segurança no ADF ou então armazenar a senha no Azure Key Vault e permitir que o ADF copie o pull de atividade desse local ao executar a cópia de dados – saiba mais sobre como Armazenar credenciais no Key Vault.You can choose to mark this field as a SecureString to store it securely in ADF, or store password in Azure Key Vault and let ADF copy activity pull from there when performing data copy - learn more from Store credentials in Key Vault. | NãoNo |
clientSecretclientSecret | O segredo do cliente do aplicativo Google usado para adquirir o token de atualização.The client secret of the google application used to acquire the refresh token. Você pode optar por marcar este campo como uma SecureString para armazená-la com segurança no ADF ou então armazenar a senha no Azure Key Vault e permitir que o ADF copie o pull de atividade desse local ao executar a cópia de dados – saiba mais sobre como Armazenar credenciais no Key Vault.You can choose to mark this field as a SecureString to store it securely in ADF, or store password in Azure Key Vault and let ADF copy activity pull from there when performing data copy - learn more from Store credentials in Key Vault. | NãoNo |
emailemail | A ID de e-mail da conta de serviço que é usada para ServiceAuthentication e que só pode ser usada em IR auto-hospedado.The service account email ID that is used for ServiceAuthentication and can only be used on self-hosted IR. | NãoNo |
keyFilePathkeyFilePath | O caminho completo para o arquivo chave .p12 que é usado para autenticar o endereço de e-mail da conta de serviço e que só pode ser usado em IR auto-hospedado.The full path to the .p12 key file that is used to authenticate the service account email address and can only be used on self-hosted IR. | NãoNo |
trustedCertPathtrustedCertPath | O caminho completo do arquivo. pem que contém certificados de AC confiáveis para verificar o servidor ao se conectar via TLS.The full path of the .pem file containing trusted CA certificates for verifying the server when connecting over TLS. Essa propriedade só pode ser definida ao usar TLS no IR auto-hospedado.This property can only be set when using TLS on self-hosted IR. O valor padrão é o arquivo de cacerts.pem instalado com o IR.The default value is the cacerts.pem file installed with the IR. | NãoNo |
useSystemTrustStoreuseSystemTrustStore | Especifica se deve usar um certificado de autoridade de certificação do repositório de confiança de sistema ou de um arquivo PEM especificado.Specifies whether to use a CA certificate from the system trust store or from a specified PEM file. O valor padrão é false.The default value is false. | NãoNo |
Exemplo:Example:
{
"name": "GoogleAdWordsLinkedService",
"properties": {
"type": "GoogleAdWords",
"typeProperties": {
"clientCustomerID" : "<clientCustomerID>",
"developerToken": {
"type": "SecureString",
"value": "<developerToken>"
},
"authenticationType" : "ServiceAuthentication",
"refreshToken": {
"type": "SecureString",
"value": "<refreshToken>"
},
"clientId": {
"type": "SecureString",
"value": "<clientId>"
},
"clientSecret": {
"type": "SecureString",
"value": "<clientSecret>"
},
"email" : "<email>",
"keyFilePath" : "<keyFilePath>",
"trustedCertPath" : "<trustedCertPath>",
"useSystemTrustStore" : true,
}
}
}
Propriedades do conjunto de dadosDataset properties
Para obter uma lista completa das seções e propriedades disponíveis para definir os conjuntos de dados, confira o artigo sobre conjuntos de dados.For a full list of sections and properties available for defining datasets, see the datasets article. Esta seção fornece uma lista das propriedades compatíveis com o conjunto de dados do Google AdWords.This section provides a list of properties supported by Google AdWords dataset.
Para copiar dados do Google AdWords, defina a propriedade type do conjunto de dados para GoogleAdWordsObject.To copy data from Google AdWords, set the type property of the dataset to GoogleAdWordsObject. Há suporte para as seguintes propriedades:The following properties are supported:
PropriedadeProperty | DescriçãoDescription | ObrigatórioRequired |
---|---|---|
typetype | A propriedade Type do conjunto de conjuntos deve ser definida como: GoogleAdWordsObjectThe type property of the dataset must be set to: GoogleAdWordsObject | SimYes |
tableNametableName | Nome da tabela.Name of the table. | Não (se "query" na fonte da atividade for especificada)No (if "query" in activity source is specified) |
ExemploExample
{
"name": "GoogleAdWordsDataset",
"properties": {
"type": "GoogleAdWordsObject",
"typeProperties": {},
"schema": [],
"linkedServiceName": {
"referenceName": "<GoogleAdWords linked service name>",
"type": "LinkedServiceReference"
}
}
}
Propriedades da atividade de cópiaCopy activity properties
Para obter uma lista completa das seções e propriedades disponíveis para definir atividades, confia o artigo Pipelines.For a full list of sections and properties available for defining activities, see the Pipelines article. Esta seção fornece uma lista das propriedades compatível com a origem do Google AdWords.This section provides a list of properties supported by Google AdWords source.
Google AdWords como origemGoogle AdWords as source
Para copiar dados do Google AdWords, defina o tipo de origem na atividade de cópia como GoogleAdWordsSource.To copy data from Google AdWords, set the source type in the copy activity to GoogleAdWordsSource. As propriedades a seguir têm suporte na seção source da atividade de cópia:The following properties are supported in the copy activity source section:
PropriedadeProperty | DescriçãoDescription | ObrigatórioRequired |
---|---|---|
typetype | A propriedade type da origem da atividade de cópia deve ser definida como: GoogleAdWordsSourceThe type property of the copy activity source must be set to: GoogleAdWordsSource | SimYes |
Consultaquery | Utiliza a consulta SQL personalizada para ler os dados.Use the custom SQL query to read data. Por exemplo: "SELECT * FROM MyTable" .For example: "SELECT * FROM MyTable" . |
Não (se "tableName" no conjunto de dados for especificado)No (if "tableName" in dataset is specified) |
Exemplo:Example:
"activities":[
{
"name": "CopyFromGoogleAdWords",
"type": "Copy",
"inputs": [
{
"referenceName": "<GoogleAdWords input dataset name>",
"type": "DatasetReference"
}
],
"outputs": [
{
"referenceName": "<output dataset name>",
"type": "DatasetReference"
}
],
"typeProperties": {
"source": {
"type": "GoogleAdWordsSource",
"query": "SELECT * FROM MyTable"
},
"sink": {
"type": "<sink type>"
}
}
}
]
Pesquisar propriedades de atividadeLookup activity properties
Para saber detalhes sobre as propriedades, verifique Pesquisar atividade.To learn details about the properties, check Lookup activity.
Próximas etapasNext steps
Para obter uma lista de armazenamentos de dados com suporte como origens e coletores pela atividade de cópia no Azure Data Factory, consulte Armazenamentos de dados com suporte.For a list of data stores supported as sources and sinks by the copy activity in Azure Data Factory, see supported data stores.