apache/beam

[Task]: Update BigQueryIO.setTriggeringFrequency documentation

Open

#23 949 ouverte le 2 nov. 2022

Voir sur GitHub
 (20 commentaires) (0 réactions) (3 assignés)Java (4 097 forks)batch import
P2bigquerygcpgood first issueiojavatask

Métriques du dépôt

Stars
 (7 313 stars)
Métriques de merge PR
 (Merge moyen 6j) (243 PRs mergées en 30 j)

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

Guide contributeur

Direction de recherche
Inspectez la documentation actuelle et la logique de validation de BigQueryIO.setTriggeringFrequency. Mettez à jour la documentation pour couvrir STORAGE WRITE API et STORAGE API AT LEAST ONCE. Ajustez également la vérification de validation dans BigQueryIO.write().expand() pour inclure STORAGE API AT LEAST ONCE.
Stack technique
java
Domaine
backend
Type d'issue
Documentation
DifficultéDifficulté estimée pour un nouveau contributeur, de 1 pour un très petit changement à 5 pour un travail expert.
3
Temps estiméFourchette de temps approximative pour investiguer, implémenter, tester et préparer une pull request.
Une demi journée
Statut d'activitéDisponibilité apparente de l'issue : fraîche, active, ancienne, bloquée ou en attente d'un mainteneur.
Active
ClartéClarté avec laquelle l'issue explique le changement attendu, les critères d'acceptation et la prochaine étape.
Claire
Prérequis
Java
Accessibilité débutantScore de 1 à 100 estimant l'accessibilité de cette issue pour un premier contributeur.
65