Recurso REST: projects.transferConfigs

Recurso: TransferConfig

Representa uma configuração de transferência de dados. Uma configuração de transferência contém todos os metadados necessários para realizar uma transferência de dados. Por exemplo, destinationDatasetId especifica onde os dados precisam ser armazenados. Quando uma nova configuração de transferência é criada, o destinationDatasetId especificado é criado quando necessário e compartilhado com a conta de serviço da fonte de dados adequada.

Representação JSON 

{
  "name": string,
  "destinationDatasetId": string,
  "displayName": string,
  "dataSourceId": string,
  "params": {
    object
  },
  "schedule": string,
  "dataRefreshWindowDays": number,
  "disabled": boolean,
  "updateTime": string,
  "nextRunTime": string,
  "state": enum(TransferState),
  "userId": string,
  "datasetRegion": string,
  "partnerToken": string,
  "partnerConnectionInfo": {
    object
  }
}
Campos
name

string

O nome do recurso da configuração de transferência. Os nomes das configurações de transferência têm o formato projects/{projectId}/locations/{region}/transferConfigs/{configId}. O nome é gerado automaticamente com base no configId especificado em CreateTransferConfigRequest junto com projectId e a região. Caso configId não seja fornecido, geralmente um uuid, mesmo que não seja garantido ou necessário, será gerado para configId.

destinationDatasetId

string

O código do conjunto de dados de destino do BigQuery.

displayName

string

Nome de exibição especificado pelo usuário para a transferência de dados.
dataSourceId

string

Código da fonte de dados. Não pode ser alterado depois que a transferência de dados é criada.

params

object (Struct format)

Parâmetros específicos de transferência de dados.
schedule

string

Programação da transferência de dados. Se a fonte de dados não for compatível com um agendamento personalizado, este parâmetro precisa ficar vazio. Nesse caso, o valor padrão para a fonte de dados será usado. Os horários especificados estão em UTC. Exemplos de formato válido: 1st,3rd monday of month 15:30, every wed,fri of jan,jun 13:15 e first sunday of quarter 00:00. Veja mais explicações sobre o formato em: https://cloud.google.com/appengine/docs/flexible/python/scheduling-jobs-with-cron-yaml#the_schedule_format Observação: a granularidade precisa ser de, pelo menos, oito horas ou menos frequente.

dataRefreshWindowDays

number

A quantidade de dias para passados para atualizar automaticamente os dados. Por exemplo, se dataRefreshWindowDays = 10, todos os dias o BigQuery receberá dados de [today-10, today-1], em vez de ingerir dados apenas por [today-1]. Válido apenas se a fonte de dados for compatível com o recurso. Defina o valor como 0 para usar o valor padrão.

disabled

boolean

Esta configuração está desativada. Quando definido como verdadeiro, nenhuma execução é planejada para uma determinada transferência.

updateTime

string (Timestamp format)

Apenas saída. Horário de modificação da transferência de dados. Ignorado pelo servidor na entrada.

Um carimbo de data/hora no formato UTC “Zulu” RFC3339, medido com precisão de nanossegundos. Exemplo: "2014-10-02T15:01:23.045123456Z".
nextRunTime

string (Timestamp format)

Apenas saída. A próxima vez que a transferência de dados será executada.

Um carimbo de data/hora no formato UTC “Zulu” RFC3339, medido com precisão de nanossegundos. Exemplo: "2014-10-02T15:01:23.045123456Z".
state

enum(TransferState)

Apenas saída. Estado da execução de transferência atualizada mais recentemente.

userId

string (int64 format)

Obsoleto. Código exclusivo do usuário que tem a transferência feita em seu nome.

datasetRegion

string

Apenas saída. Região na qual o conjunto de dados do BigQuery está localizado.

partnerToken

string

Um identificador exclusivo usado para identificar uma configuração de transferência armazenada no lado do parceiro externo. O token é opaco para DTS e só pode ser interpretado pelo parceiro. A fonte de dados do parceiro precisa criar um mapeamento entre o código de configuração e o token para confirmar que uma configuração/execução de transferência é legítima.

partnerConnectionInfo

object (Struct format)

Configurações de transferência gerenciadas por fontes de dados do parceiro. São armazenadas como pares de chave-valor e usadas apenas para fins de exibição de IU do DTS. Há dois motivos para não querer armazená-las em conjunto com "params": as informações de conexão são fornecidas pelo parceiro e não podem ser editadas na IU do DTS, que é diferente do parâmetro imutável. Não será necessário adicionar outro booleano ao DataSourceParameter para diferenciá-las. As informações de conexão podem ser qualquer par de chave-valor arbitrário. Para adicioná-las aos campos de parâmetros, o parceiro precisa fornecer a definição para elas na definição da fonte de dados. Será mais fácil evitar isso para os parceiros.

Métodos

create

 Cria uma nova configuração de transferência de dados.

delete

 Exclui uma configuração de transferência de dados, incluindo execuções de transferência e registros associados.

get

 Retorna informações sobre uma configuração de transferência de dados.

list

 Retorna informações sobre todas as transferências de dados no projeto.

patch

 Atualiza uma configuração de transferência de dados.

scheduleRuns

 Cria execuções de transferência para um intervalo de tempo [start_time, end_time].