Docs lack guidance about choosing job_name parameter

[inglesp]

Many methods on google.cloud.bigquery.client.Client take a job_name as their parameter but there's no guidance in the docs about what the job_name should be.

Investigation suggests it needs to be unique, and this is confirmed under the "Generating a job ID" section of this page (which I found through Googling). That page also suggests using eg Python's uuid.uuid4().

Could some advice about choosing job_name be added to https://googlecloudplatform.github.io/google-cloud-python/latest/bigquery/client.html?

And better, although it'd be a backwards-incompatible change, could job_name be an optional parameter that's generated automatically by BQ?

[lukesneeringer]

Hi @inglesp,
So, having BigQuery itself generate a job_name is actually a little bit of an anti-pattern, because that has an undesirable effect on retries. So, we want the client library to do it. However, we do have a plan to make it such that you to not have to specify the job_name, and the client library will do it for you (using uuid.uuid4()), which mitigates this.

[lukesneeringer]

Hmm, I thought we had an issue open for this, but I do not see one (I might have closed it by accident last week), so leaving this one open. :-)

[tswast]

Duplicate of #3209.

[lukesneeringer]

Okay, we did have one. Thanks.