runt18 / google-bigquery

Automatically exported from code.google.com/p/google-bigquery
0 stars 0 forks source link

Allow table to have description as fields do #472

Closed GoogleCodeExporter closed 8 years ago

GoogleCodeExporter commented 8 years ago
* What is the desired behavior of the feature? (Be specific!)
-> Users would like to be able to add table descriptions when uploading files 
from Google Cloud Storage as the configuration.load.schema.fields[].description 
does for the fields per [1].

* If relevant, why are current approaches or workarounds insufficient?
-> There is a gap of displaying the tables purpose between the write truncate 
and when the patch, and there is no current approaches or workarounds to add 
descriptions for tables;

* If relevant, what new use cases will this feature will enable?
-> People will be able to immediately understand what a table is when it 
appears and to have that information attached even if the process creating if 
fails, etc. 

[1] https://cloud.google.com/bigquery/docs/reference/v2/jobs#configuration.load

Original issue reported on code.google.com by ju...@google.com on 19 Mar 2016 at 3:10

GoogleCodeExporter commented 8 years ago
You can set a table description via the tables.insert or tables.update method, 
using this property:

https://cloud.google.com/bigquery/docs/reference/v2/tables#description

You cannot set this property via the load job configuration, but there are 
several other properties that can only be set via tables.update, and I'm not 
sure we want to go down the road of allowing all table properties to be 
configuration.load properties too. If you feel strongly otherwise, please 
reopen.

Original comment by jcon...@google.com on 19 Mar 2016 at 4:55