import * as pulumi from "@pulumi/pulumi"; import * as inputs from "../../types/input"; import * as outputs from "../../types/output"; /** * Creates a new empty dataset. * Auto-naming is currently not supported for this resource. */ export declare class Dataset extends pulumi.CustomResource { /** * Get an existing Dataset resource's state with the given name, ID, and optional extra * properties used to qualify the lookup. * * @param name The _unique_ name of the resulting resource. * @param id The _unique_ provider ID of the resource to lookup. * @param opts Optional settings to control the behavior of the CustomResource. */ static get(name: string, id: pulumi.Input, opts?: pulumi.CustomResourceOptions): Dataset; /** * Returns true if the given object is an instance of Dataset. This is designed to work even * when multiple copies of the Pulumi SDK have been loaded into the same process. */ static isInstance(obj: any): obj is Dataset; /** * [Optional] An array of objects that define dataset access for one or more entities. You can set this property when inserting or updating a dataset in order to control who is allowed to access the data. If unspecified at dataset creation time, BigQuery adds default dataset access for the following entities: access.specialGroup: projectReaders; access.role: READER; access.specialGroup: projectWriters; access.role: WRITER; access.specialGroup: projectOwners; access.role: OWNER; access.userByEmail: [dataset creator email]; access.role: OWNER; */ readonly access: pulumi.Output; /** * The time when this dataset was created, in milliseconds since the epoch. */ readonly creationTime: pulumi.Output; /** * [Required] A reference that identifies the dataset. */ readonly datasetReference: pulumi.Output; /** * The default collation of the dataset. */ readonly defaultCollation: pulumi.Output; readonly defaultEncryptionConfiguration: pulumi.Output; /** * [Optional] The default partition expiration for all partitioned tables in the dataset, in milliseconds. Once this property is set, all newly-created partitioned tables in the dataset will have an expirationMs property in the timePartitioning settings set to this value, and changing the value will only affect new tables, not existing ones. The storage in a partition will have an expiration time of its partition time plus this value. Setting this property overrides the use of defaultTableExpirationMs for partitioned tables: only one of defaultTableExpirationMs and defaultPartitionExpirationMs will be used for any new partitioned table. If you provide an explicit timePartitioning.expirationMs when creating or updating a partitioned table, that value takes precedence over the default partition expiration time indicated by this property. */ readonly defaultPartitionExpirationMs: pulumi.Output; /** * The default rounding mode of the dataset. */ readonly defaultRoundingMode: pulumi.Output; /** * [Optional] The default lifetime of all tables in the dataset, in milliseconds. The minimum value is 3600000 milliseconds (one hour). Once this property is set, all newly-created tables in the dataset will have an expirationTime property set to the creation time plus the value in this property, and changing the value will only affect new tables, not existing ones. When the expirationTime for a given table is reached, that table will be deleted automatically. If a table's expirationTime is modified or removed before the table expires, or if you provide an explicit expirationTime when creating a table, that value takes precedence over the default expiration time indicated by this property. */ readonly defaultTableExpirationMs: pulumi.Output; /** * [Optional] A user-friendly description of the dataset. */ readonly description: pulumi.Output; /** * A hash of the resource. */ readonly etag: pulumi.Output; /** * [Optional] Information about the external metadata storage where the dataset is defined. Filled out when the dataset type is EXTERNAL. */ readonly externalDatasetReference: pulumi.Output; /** * [Optional] A descriptive name for the dataset. */ readonly friendlyName: pulumi.Output; /** * [Optional] Indicates if table names are case insensitive in the dataset. */ readonly isCaseInsensitive: pulumi.Output; /** * The resource type. */ readonly kind: pulumi.Output; /** * The labels associated with this dataset. You can use these to organize and group your datasets. You can set this property when inserting or updating a dataset. See Creating and Updating Dataset Labels for more information. */ readonly labels: pulumi.Output<{ [key: string]: string; }>; /** * The date when this dataset or any of its tables was last modified, in milliseconds since the epoch. */ readonly lastModifiedTime: pulumi.Output; /** * The geographic location where the dataset should reside. The default value is US. See details at https://cloud.google.com/bigquery/docs/locations. */ readonly location: pulumi.Output; /** * [Optional] Number of hours for the max time travel for all tables in the dataset. */ readonly maxTimeTravelHours: pulumi.Output; readonly project: pulumi.Output; /** * Reserved for future use. */ readonly satisfiesPzs: pulumi.Output; /** * A URL that can be used to access the resource again. You can use this URL in Get or Update requests to the resource. */ readonly selfLink: pulumi.Output; /** * [Optional] Storage billing model to be used for all tables in the dataset. Can be set to PHYSICAL. Default is LOGICAL. */ readonly storageBillingModel: pulumi.Output; /** * [Optional]The tags associated with this dataset. Tag keys are globally unique. */ readonly tags: pulumi.Output; /** * Create a Dataset resource with the given unique name, arguments, and options. * * @param name The _unique_ name of the resource. * @param args The arguments to use to populate this resource's properties. * @param opts A bag of options that control this resource's behavior. */ constructor(name: string, args?: DatasetArgs, opts?: pulumi.CustomResourceOptions); } /** * The set of arguments for constructing a Dataset resource. */ export interface DatasetArgs { /** * [Optional] An array of objects that define dataset access for one or more entities. You can set this property when inserting or updating a dataset in order to control who is allowed to access the data. If unspecified at dataset creation time, BigQuery adds default dataset access for the following entities: access.specialGroup: projectReaders; access.role: READER; access.specialGroup: projectWriters; access.role: WRITER; access.specialGroup: projectOwners; access.role: OWNER; access.userByEmail: [dataset creator email]; access.role: OWNER; */ access?: pulumi.Input[]>; /** * [Required] A reference that identifies the dataset. */ datasetReference?: pulumi.Input; defaultEncryptionConfiguration?: pulumi.Input; /** * [Optional] The default partition expiration for all partitioned tables in the dataset, in milliseconds. Once this property is set, all newly-created partitioned tables in the dataset will have an expirationMs property in the timePartitioning settings set to this value, and changing the value will only affect new tables, not existing ones. The storage in a partition will have an expiration time of its partition time plus this value. Setting this property overrides the use of defaultTableExpirationMs for partitioned tables: only one of defaultTableExpirationMs and defaultPartitionExpirationMs will be used for any new partitioned table. If you provide an explicit timePartitioning.expirationMs when creating or updating a partitioned table, that value takes precedence over the default partition expiration time indicated by this property. */ defaultPartitionExpirationMs?: pulumi.Input; /** * [Optional] The default lifetime of all tables in the dataset, in milliseconds. The minimum value is 3600000 milliseconds (one hour). Once this property is set, all newly-created tables in the dataset will have an expirationTime property set to the creation time plus the value in this property, and changing the value will only affect new tables, not existing ones. When the expirationTime for a given table is reached, that table will be deleted automatically. If a table's expirationTime is modified or removed before the table expires, or if you provide an explicit expirationTime when creating a table, that value takes precedence over the default expiration time indicated by this property. */ defaultTableExpirationMs?: pulumi.Input; /** * [Optional] A user-friendly description of the dataset. */ description?: pulumi.Input; /** * [Optional] Information about the external metadata storage where the dataset is defined. Filled out when the dataset type is EXTERNAL. */ externalDatasetReference?: pulumi.Input; /** * [Optional] A descriptive name for the dataset. */ friendlyName?: pulumi.Input; /** * [Optional] Indicates if table names are case insensitive in the dataset. */ isCaseInsensitive?: pulumi.Input; /** * The labels associated with this dataset. You can use these to organize and group your datasets. You can set this property when inserting or updating a dataset. See Creating and Updating Dataset Labels for more information. */ labels?: pulumi.Input<{ [key: string]: pulumi.Input; }>; /** * The geographic location where the dataset should reside. The default value is US. See details at https://cloud.google.com/bigquery/docs/locations. */ location?: pulumi.Input; /** * [Optional] Number of hours for the max time travel for all tables in the dataset. */ maxTimeTravelHours?: pulumi.Input; project?: pulumi.Input; /** * [Optional] Storage billing model to be used for all tables in the dataset. Can be set to PHYSICAL. Default is LOGICAL. */ storageBillingModel?: pulumi.Input; /** * [Optional]The tags associated with this dataset. Tag keys are globally unique. */ tags?: pulumi.Input[]>; }