googleapis / googleapis/google-api-ruby-client

Need to support dataset.list and jobs.list API new field feature

Abierto
#16,987 0 comentarios 0 reacciones 0 asignados Ver en GitHub
Lenguaje dominante
Ruby
Estrellas
2.9k
Forks
888
Merge medio
6 min
PR fusionados (30 d)
218

Descripción

Hello,

I have received the following email from Google:
```
Hello Google BigQuery Customer,

We are writing to let you know that a new field will be added to the response of the datasets.list API and jobs.list API calls in BigQuery starting February 15, 2024.

What do you need to know?
Currently, in the rare event that one or more GCP regions become unreachable for a prolonged period, datasets.list and jobs.list API calls will fail if the response should include data from the unreachable region.

Starting February 15, 2024, these calls will succeed, but with the additional field `unreachable` included to indicate the locations where data might have been omitted from the datasets.list and jobs.list responses due to the prolonged unreachability of the entire region or multi-region.

Under normal circumstances, this field will be empty. However, if you depend on retrieving a complete list of all your datasets and jobs from the datasets.list and jobs.list APIs, you should start considering the values of this new field when present.

What do I need to do?
We recommend the following steps to make the most of the new field provided in the output:

1. Review the regions from which you are making datasets.list and jobs.list API calls.
2. After February 15, 2024, review the new "unreachable" field in the datasets.list and jobs.list API responses.
3. Examine the contents of this field to identify any unreachable locations. If your API integration with BigQuery relies on obtaining a full list of datasets/jobs from all regions/multi-regions where relevant data exists, you may need to adjust your integration based on specific scenarios.
4. Depending on the situation, you may choose to fail the workflow, issue a warning, or continue without warning if the `unreachable` field is populated.

These recommended actions will help you ensure that you are receiving a complete list of datasets from all regions.

Thank you for choosing Google Big Query.
```

It appears that a new unreachable field will be added to the jobs.list and datasets.list APIs. This change will modify the interfaces of these two APIs. When can I expect this SDK to be updated to reflect this change?

Guía de contribución

Abrir la guía de contribución

Línea de trabajo

Empieza por localizar las definiciones de BigQuery generadas para las API datasets.list y jobs.list e inspeccionar sus representaciones de respuesta. Confirma cómo se exponen los nuevos campos de respuesta en el cliente de Ruby y, a continuación, verifica que ambas API incluyan el campo unreachable y ejecuta las pruebas relevantes del repositorio o las comprobaciones de generación, si están disponibles.

Escrito por el modelo de indexación a partir del texto del issue.

Evaluación

Stack tecnológico
google-cloud, ruby
Área
api, cloud
Tipo de issue
Nueva funcionalidad
Dificultad
3/5
Tiempo estimado
1-2 días
Estado de actividad
Estancado
Claridad
Bastante claro
Aptitud para principiantes
35/100

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.