Leitura de entidades do Salesforce Marketing Cloud Account Engagement - AWS Glue
Particionamento de consultas

Leitura de entidades do Salesforce Marketing Cloud Account Engagement

Pré-requisito

Um objeto do Salesforce Marketing Cloud Account Engagement do qual você deseja ler. Você precisará do nome do objeto.

Entidades compatíveis com a fonte de Sync:

Entidade Pode ser filtrada Oferece suporte a limite Oferece suporte a Ordenar por Oferece suporte a Selecionar * Oferece suporte a particionamento
Campaign Sim Sim Sim Sim Sim
Dynamic Content Sim Sim Sim Sim Sim
E-mail Sim Sim Sim Sim Sim
Modelo de e-mail Sim Sim Sim Sim Sim
Engagement Studio Program Sim Sim Sim Sim Sim
Conteúdo da pasta Sim Sim Sim Sim Sim
Página de destino Sim Sim Sim Sim Sim
Histórico do ciclo de vida Sim Sim Sim Sim Sim
Estágio do ciclo de vida Sim Sim Sim Sim Sim
Lista Sim Sim Sim Sim Sim
Listar e-mail Sim Sim Sim Sim Sim
Listar associação Sim Sim Sim Sim Sim
Oportunidade Sim Sim Sim Sim Sim
Cliente potencial Sim Sim Sim Sim Sim
Conta de cliente potencial Sim Sim Sim Sim Sim
Usuário Sim Sim Sim Sim Sim

Exemplo:

salesforcepardot_read = glueContext.create_dynamic_frame.from_options(
    connection_type="SalesforcePardot",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "entityName",
        "API_VERSION": "v5"
    }
   )

Entidades compatíveis com a fonte de ASYNC:

Entidade Pode ser filtrada Oferece suporte a limite Oferece suporte a Ordenar por Oferece suporte a Selecionar * Oferece suporte a particionamento
Campaign Sim Não Não Sim Não
Dynamic Content Sim Não Não Sim Não
Modelo de e-mail Sim Não Não Sim Não
Página de destino Sim Não Não Sim Não
Histórico do ciclo de vida Sim Não Não Sim Não
Estágio do ciclo de vida Sim Não Não Sim Não
Lista Sim Não Não Sim Não
Listar e-mail Sim Não Não Sim Não
Listar associação Sim Não Não Sim Não
Oportunidade Sim Não Não Sim Não
Cliente potencial Sim Não Não Sim Não
Conta de cliente potencial Sim Não Não Sim Não
Usuário Sim Não Não Sim Não

Exemplo:

salesforcepardot_read = glueContext.create_dynamic_frame.from_options(
    connection_type="SalesforcePardot",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "entityName",
        "API_VERSION": "v5",
        "TRANSFER_MODE": "ASYNC"
    }
   )

Detalhes dos campos e das entidades do Salesforce Marketing Cloud Account Engagement:

Para visualizar os detalhes dos campos das entidades a seguir, navegue até API do Salesforce Marketing Cloud Account Engagement, escolha Guias, role para baixo até Wrappers de APIs de código aberto, expanda Documentos da versão 5 no menu e escolha uma entidade.

Lista de entidades:

  • Campaign

  • Dynamic Content

  • E-mail

  • Modelo de e-mail

  • Engagement Studio Program

  • Conteúdo da pasta

  • Página de destino

  • Histórico do ciclo de vida

  • Estágio do ciclo de vida

  • Lista

  • Listar e-mail

  • Listar associação

  • Oportunidade

  • Cliente potencial

  • Conta de cliente potencial

  • Usuário

Além dos campos mencionados acima, o modo ASYNC é compatível com campos filtráveis específicos para cada entidade, conforme mostrado na tabela abaixo.

Entidade Campos filtráveis adicionais compatíveis no modo ASYNC
Campaign createdAfter, createdBefore, deleted, updatedAfter, updatedBefore
Dynamic Content createdAfter, createdBefore, deleted, updatedAfter, updatedBefore
Modelo de e-mail createdAfter, createdBefore, deleted, updatedAfter, updatedBefore
Engagement Studio Program -
Página de destino createdAfter, createdBefore, deleted, updatedAfter, updatedBefore
Histórico do ciclo de vida createdAfter, createdBefore
Estágio do ciclo de vida createdAfter, createdBefore, deleted, updatedAfter, updatedBefore
Lista createdAfter, createdBefore, deleted, updatedAfter, updatedBefore
Listar e-mail createdAfter, createdBefore, deleted, updatedAfter, updatedBefore
Listar associação createdAfter, createdBefore, deleted, updatedAfter, updatedBefore
Oportunidade createdAfter, createdBefore, deleted, updatedAfter, updatedBefore
Cliente potencial createdAfter, createdBefore, deleted, updatedAfter, updatedBefore
Conta de cliente potencial createdAfter, createdBefore, deleted
Usuário createdAfter, createdBefore, deleted, updatedAfter, updatedBefore

Para obter mais informações sobre os campos adicionais, consulte Salesforce Export API

Observe as seguintes considerações sobre o conector:

  • O valor do campo delete nas entidades pode ser false (padrão), true ou all.

Particionamento de consultas

Particionamento baseado em filtro:

É possível fornecer as opções adicionais do Spark PARTITION_FIELD, LOWER_BOUND, UPPER_BOUND e NUM_PARTITIONS se quiser utilizar a simultaneidade no Spark. Com esses parâmetros, a consulta original seria dividida em NUM_PARTITIONS subconsultas, que poderiam ser executadas pelas tarefas do Spark simultaneamente.

  • PARTITION_FIELD: o nome do campo a ser usado para particionar a consulta.

  • LOWER_BOUND: um valor limite inferior inclusivo do campo de partição escolhido.

    No campo Data e hora, aceitamos o formato de carimbo de data/hora do Spark usado em consultas SQL do Spark.

    Exemplos de valores válidos:

    "2022-01-01T01:01:01.000Z"

  • UPPER_BOUND: um valor limite superior exclusivo do campo de partição escolhido.

  • NUM_PARTITIONS: o número de partições.

  • PARTITION_BY: o tipo de particionamento a ser executado. “FIELD” deve ser passado no caso de particionamento com base em campo.

Exemplo:

salesforcepardot_read = glueContext.create_dynamic_frame.from_options(
    connection_type="salesforcepardot",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "entityName",
        "API_VERSION": "v5",
        "PARTITION_FIELD": "createdAt"
        "LOWER_BOUND": "2022-01-01T01:01:01.000Z"
        "UPPER_BOUND": "2024-01-01T01:01:01.000Z"
        "NUM_PARTITIONS": "10",
        "PARTITION_BY": "FIELD"
    }
   )