Please update documentation to indicate which function calls, or if this entire package uses, legacy APIs #1343
Labels
api: bigquery
Issues related to the googleapis/nodejs-bigquery API.
priority: p3
Desirable enhancement or fix. May not be included in next release.
type: question
Request for information or clarification. Not an issue.
Is your feature request related to a problem? Please describe.
I recently ran into this problem, and I did not expect it. https://cloud.google.com/knowledge/kb/cannot-update-or-delete-over-bigquery-streaming-tables-000004334 I had spent a lot of time figuring out how to make use of this package in a Bun env to discover that I was using a legacy API that introduces certain caveats, like I can't delete data that I inserted using insertAll until the buffer clears (I think.). And that I should be using a different API and package instead.
Describe the solution you'd like
I would like the Rest API docs and the Client SDK documentation to be updated to clearly indicate which methods or endpoints are a legacy API. Like
table.insert()
-> https://cloud.google.com/bigquery/docs/reference/rest/v2/tabledata/insertAll -> ... -> https://cloud.google.com/bigquery/docs/data-manipulation-language#limitations or something like that.Describe alternatives you've considered
Talking to ChatGPT or another AI might be more helpful for figuring out why I had issues.
The text was updated successfully, but these errors were encountered: