apache/beam

[Task]: Update BigQueryIO.setTriggeringFrequency documentation

Open

#23.949 aberto em 2 de nov. de 2022

Ver no GitHub
 (20 comments) (0 reactions) (3 assignees)Java (4.097 forks)batch import
P2bigquerygcpgood first issueiojavatask

Métricas do repositório

Stars
 (7.313 stars)
Métricas de merge de PR
 (Mesclagem média 6d) (243 fundiu PRs em 30d)

Description

What needs to happen?

BigQueryIO currently documents triggering frequency as:

This is only applicable when the write method is set to {@link Method#FILE_LOADS}, and only when writing an unbounded {@link PCollection}.

However, we use triggering frequency for STORAGE_WRITE_API and STORAGE_API_AT_LEAST_ONCE as well. This documentation should be updated to reflect this.

In addition, during the validation component of BigQueryIO.write().expand(), we check for unbounded && (file loads || storage write api) to see if a triggering frequency is set. This should probably also be checked if storage write at least once is set.

Issue Priority

Priority: 2

Issue Component

Component: io-java-gcp

Guia do colaborador

Direção de pesquisa
Inspecione a documentação atual e a lógica de validação do BigQueryIO.setTriggeringFrequency. Atualize a documentação para cobrir STORAGE WRITE API e STORAGE API AT LEAST ONCE. Ajuste também a verificação de validação em BigQueryIO.write().expand() para incluir STORAGE API AT LEAST ONCE.
Pilha de tecnologia
java
Domain
backend
Tipo Issue
Documentação
DifficultyDificuldade de implementação estimada para um novo contribuidor, de 1 para alterações muito pequenas a 5 para trabalho de nível especializado.
3
Tempo estimadoUm intervalo de tempo aproximado para um colaborador experiente investigar, implementar, testar e preparar um pull request.
Meio dia
Status da atividadeQuão disponível o issue aparece agora: novo, ativo, obsoleto, bloqueado ou aguardando entrada do mantenedor.
Ativo
ClarityCom que clareza o issue explica a mudança esperada, os critérios de aceitação e a próxima etapa.
Claro
Prerequisites
Java
Simpatia para novatosUma pontuação de 1 a 100 que estima o quão acessível este issue é para colaboradores iniciantes.
65