Arquivos de controle de transferência para transferências de arquivos de log

Última atualização em 2023-05-20

Controle de transferência (.info) os arquivos fornecem informações de metadados sobre transferências de arquivos para que os parceiros possam verificar se o Audience Manager manipulou as transferências de arquivos corretamente.

Audience Manager envia um arquivo de controle de transferência para um parceiro com cada transferência de arquivo. Devido à natureza multithread da FTP editor, o arquivo de controle de transferência pode ser enviado antes que os arquivos reais sejam transferidos.

Os metadados na variável .info o arquivo permite aos parceiros:

  • Determinar quando um ciclo de transferência completo está concluído (o número total de arquivos na sequência foi entregue);
  • Determinar se determinado arquivo na sequência está completo/correto (examinando o tamanho do arquivo em bytes e o número total de linhas);
  • Validar o número de linhas em arquivos brutos versus o número de linhas depois que os arquivos forem carregados no banco de dados no final de recebimento (tamanho do arquivo em linhas).

Convenções de nomenclatura de arquivos

O arquivo de controle de transferência tem o mesmo nome que a raiz do lote/sequência com um .info extensão de arquivo.s

Por exemplo, se o primeiro arquivo na sequência fosse nomeado como: ftp_12345_67890_full_1500727351632-1.sync, o arquivo de controle seria nomeado como ftp_12345_67890_iter_1500727351632.info.

Formato do arquivo

{
  Files: [
    {
      FileByteSize: 293029329,
      FileLineCount: 36893908,
      FileName: "ftp_12345_67890_full_1500727351632-1.sync.gz",
      FileSequenceNumber: 1,
      md5: "983g634be2ad5263c6a6c4958bf61d9f"
    },
    {
      FileByteSize: 293039238,
      FileLineCount: 36895184,
      FileName: "ftp_12345_67890_full_1500727351632-2.sync.gz",
      FileSequenceNumber: 2,
      md5: "6sn9907c8e78cfd78409622e7b55a984"
    },
    {
      FileByteSize: 293050833,
      FileLineCount: 36896787,
      FileName: "ftp_12345_67890_full_1500727351632-3.sync.gz",
      FileSequenceNumber: 3,
      md5: "7cdfb8e74cd6cec1jy6vel21ccb4a962"
    },
    {
      FileByteSize: 218425764,
      FileLineCount: 27498226,
      FileName: "ftp_12345_67890_full_1500727351632-4.sync.gz",
      FileSequenceNumber: 4,
      md5: "7hs53149f8a2444457g968f04cbbdee5"
    }
  ],
  Totals: {
    FileName: "ftp_12345_67890_full_1500727351632.sync",
    TotalByteSize: 1097545164,
    TotalNumberFiles: 4,
    TotalNumberLines: 138184105
    }
}
OBSERVAÇÃO

Os números totais do lote excluem os .info próprio arquivo. Ou seja, os totais não incluem a .info arquivo, seu tamanho em bytes ou sua contagem de linhas.

Os tamanhos de bytes de arquivos e contagens de linhas incluem linhas/linhas de cabeçalho e espaçador (em branco). Para obter a contagem de linhas/linhas de dados reais, subtraia os cabeçalhos.

As linhas totais em lote e o tamanho total em bytes incluem qualquer linha de cabeçalho e espaço.

Nesta página