Database Reference
In-Depth Information
number
Last time the dataset
metadata was modified, in
milliseconds since 1/1/1970.
Does not get updated when
tables get created or
updated. Set automatically.
lastModifiedTime
string
Friendly name for the
dataset. Not unique.
friendlyName
string
Free-text description of the
dataset.
description
Datasets.insert()
The
Datasets.insert()
operation is the only way to create a new
dataset. The only fields you need to specify are the dataset and project IDs,
but if you choose to specify an ACL or a friendly name, those will also work.
The dataset inherits the project ACL by default; project readers become
dataset readers, project editors become dataset writers, and project owners
become dataset owners. If you specify an ACL with no owners, you will be
added as an owner. Here is the output of using
curl
to create a dataset:
$
DATASET_REF="{'datasetId': 'scratch', 'projectId':
'${PROJECT_ID}'}"
$
DATASETS_URL=${PROJECT_URL}/datasets
$
curl -H "$(python auth.py)" \
-
H "Content-Type: application/json" \
-
X POST \
--
data-binary "{'datasetReference':
${DATASET_REF}}" \
"${DATASETS_URL}"
{
…
"datasetReference": {
"datasetId": "scratch",
"projectId": "bigquery-e2e"
},
"access": [
{
