com.pulumi.gcp.bigquery.kotlin.Dataset.kt Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of pulumi-gcp-kotlin Show documentation
Show all versions of pulumi-gcp-kotlin Show documentation
Build cloud applications and infrastructure by combining the safety and reliability of infrastructure as code with the power of the Kotlin programming language.
@file:Suppress("NAME_SHADOWING", "DEPRECATION")
package com.pulumi.gcp.bigquery.kotlin
import com.pulumi.core.Output
import com.pulumi.gcp.bigquery.kotlin.outputs.DatasetAccess
import com.pulumi.gcp.bigquery.kotlin.outputs.DatasetDefaultEncryptionConfiguration
import com.pulumi.gcp.bigquery.kotlin.outputs.DatasetExternalDatasetReference
import com.pulumi.kotlin.KotlinCustomResource
import com.pulumi.kotlin.PulumiTagMarker
import com.pulumi.kotlin.ResourceMapper
import com.pulumi.kotlin.options.CustomResourceOptions
import com.pulumi.kotlin.options.CustomResourceOptionsBuilder
import com.pulumi.resources.Resource
import kotlin.Boolean
import kotlin.Int
import kotlin.String
import kotlin.Suppress
import kotlin.Unit
import kotlin.collections.List
import kotlin.collections.Map
import com.pulumi.gcp.bigquery.kotlin.outputs.DatasetAccess.Companion.toKotlin as datasetAccessToKotlin
import com.pulumi.gcp.bigquery.kotlin.outputs.DatasetDefaultEncryptionConfiguration.Companion.toKotlin as datasetDefaultEncryptionConfigurationToKotlin
import com.pulumi.gcp.bigquery.kotlin.outputs.DatasetExternalDatasetReference.Companion.toKotlin as datasetExternalDatasetReferenceToKotlin
/**
* Builder for [Dataset].
*/
@PulumiTagMarker
public class DatasetResourceBuilder internal constructor() {
public var name: String? = null
public var args: DatasetArgs = DatasetArgs()
public var opts: CustomResourceOptions = CustomResourceOptions()
/**
* @param name The _unique_ name of the resulting resource.
*/
public fun name(`value`: String) {
this.name = value
}
/**
* @param block The arguments to use to populate this resource's properties.
*/
public suspend fun args(block: suspend DatasetArgsBuilder.() -> Unit) {
val builder = DatasetArgsBuilder()
block(builder)
this.args = builder.build()
}
/**
* @param block A bag of options that control this resource's behavior.
*/
public suspend fun opts(block: suspend CustomResourceOptionsBuilder.() -> Unit) {
this.opts = com.pulumi.kotlin.options.CustomResourceOptions.opts(block)
}
internal fun build(): Dataset {
val builtJavaResource = com.pulumi.gcp.bigquery.Dataset(
this.name,
this.args.toJava(),
this.opts.toJava(),
)
return Dataset(builtJavaResource)
}
}
/**
* ## Example Usage
* ### Bigquery Dataset Basic
*
* ```typescript
* import * as pulumi from "@pulumi/pulumi";
* import * as gcp from "@pulumi/gcp";
* const bqowner = new gcp.serviceaccount.Account("bqowner", {accountId: "bqowner"});
* const dataset = new gcp.bigquery.Dataset("dataset", {
* datasetId: "example_dataset",
* friendlyName: "test",
* description: "This is a test description",
* location: "EU",
* defaultTableExpirationMs: 3600000,
* labels: {
* env: "default",
* },
* accesses: [
* {
* role: "OWNER",
* userByEmail: bqowner.email,
* },
* {
* role: "READER",
* domain: "hashicorp.com",
* },
* ],
* });
* ```
* ```python
* import pulumi
* import pulumi_gcp as gcp
* bqowner = gcp.serviceaccount.Account("bqowner", account_id="bqowner")
* dataset = gcp.bigquery.Dataset("dataset",
* dataset_id="example_dataset",
* friendly_name="test",
* description="This is a test description",
* location="EU",
* default_table_expiration_ms=3600000,
* labels={
* "env": "default",
* },
* accesses=[
* gcp.bigquery.DatasetAccessArgs(
* role="OWNER",
* user_by_email=bqowner.email,
* ),
* gcp.bigquery.DatasetAccessArgs(
* role="READER",
* domain="hashicorp.com",
* ),
* ])
* ```
* ```csharp
* using System.Collections.Generic;
* using System.Linq;
* using Pulumi;
* using Gcp = Pulumi.Gcp;
* return await Deployment.RunAsync(() =>
* {
* var bqowner = new Gcp.ServiceAccount.Account("bqowner", new()
* {
* AccountId = "bqowner",
* });
* var dataset = new Gcp.BigQuery.Dataset("dataset", new()
* {
* DatasetId = "example_dataset",
* FriendlyName = "test",
* Description = "This is a test description",
* Location = "EU",
* DefaultTableExpirationMs = 3600000,
* Labels =
* {
* { "env", "default" },
* },
* Accesses = new[]
* {
* new Gcp.BigQuery.Inputs.DatasetAccessArgs
* {
* Role = "OWNER",
* UserByEmail = bqowner.Email,
* },
* new Gcp.BigQuery.Inputs.DatasetAccessArgs
* {
* Role = "READER",
* Domain = "hashicorp.com",
* },
* },
* });
* });
* ```
* ```go
* package main
* import (
* "github.com/pulumi/pulumi-gcp/sdk/v7/go/gcp/bigquery"
* "github.com/pulumi/pulumi-gcp/sdk/v7/go/gcp/serviceaccount"
* "github.com/pulumi/pulumi/sdk/v3/go/pulumi"
* )
* func main() {
* pulumi.Run(func(ctx *pulumi.Context) error {
* bqowner, err := serviceaccount.NewAccount(ctx, "bqowner", &serviceaccount.AccountArgs{
* AccountId: pulumi.String("bqowner"),
* })
* if err != nil {
* return err
* }
* _, err = bigquery.NewDataset(ctx, "dataset", &bigquery.DatasetArgs{
* DatasetId: pulumi.String("example_dataset"),
* FriendlyName: pulumi.String("test"),
* Description: pulumi.String("This is a test description"),
* Location: pulumi.String("EU"),
* DefaultTableExpirationMs: pulumi.Int(3600000),
* Labels: pulumi.StringMap{
* "env": pulumi.String("default"),
* },
* Accesses: bigquery.DatasetAccessTypeArray{
* &bigquery.DatasetAccessTypeArgs{
* Role: pulumi.String("OWNER"),
* UserByEmail: bqowner.Email,
* },
* &bigquery.DatasetAccessTypeArgs{
* Role: pulumi.String("READER"),
* Domain: pulumi.String("hashicorp.com"),
* },
* },
* })
* if err != nil {
* return err
* }
* return nil
* })
* }
* ```
* ```java
* package generated_program;
* import com.pulumi.Context;
* import com.pulumi.Pulumi;
* import com.pulumi.core.Output;
* import com.pulumi.gcp.serviceaccount.Account;
* import com.pulumi.gcp.serviceaccount.AccountArgs;
* import com.pulumi.gcp.bigquery.Dataset;
* import com.pulumi.gcp.bigquery.DatasetArgs;
* import com.pulumi.gcp.bigquery.inputs.DatasetAccessArgs;
* import java.util.List;
* import java.util.ArrayList;
* import java.util.Map;
* import java.io.File;
* import java.nio.file.Files;
* import java.nio.file.Paths;
* public class App {
* public static void main(String[] args) {
* Pulumi.run(App::stack);
* }
* public static void stack(Context ctx) {
* var bqowner = new Account("bqowner", AccountArgs.builder()
* .accountId("bqowner")
* .build());
* var dataset = new Dataset("dataset", DatasetArgs.builder()
* .datasetId("example_dataset")
* .friendlyName("test")
* .description("This is a test description")
* .location("EU")
* .defaultTableExpirationMs(3600000)
* .labels(Map.of("env", "default"))
* .accesses(
* DatasetAccessArgs.builder()
* .role("OWNER")
* .userByEmail(bqowner.email())
* .build(),
* DatasetAccessArgs.builder()
* .role("READER")
* .domain("hashicorp.com")
* .build())
* .build());
* }
* }
* ```
* ```yaml
* resources:
* dataset:
* type: gcp:bigquery:Dataset
* properties:
* datasetId: example_dataset
* friendlyName: test
* description: This is a test description
* location: EU
* defaultTableExpirationMs: 3.6e+06
* labels:
* env: default
* accesses:
* - role: OWNER
* userByEmail: ${bqowner.email}
* - role: READER
* domain: hashicorp.com
* bqowner:
* type: gcp:serviceaccount:Account
* properties:
* accountId: bqowner
* ```
*
* ### Bigquery Dataset Cmek
*
* ```typescript
* import * as pulumi from "@pulumi/pulumi";
* import * as gcp from "@pulumi/gcp";
* const keyRing = new gcp.kms.KeyRing("key_ring", {
* name: "example-keyring",
* location: "us",
* });
* const cryptoKey = new gcp.kms.CryptoKey("crypto_key", {
* name: "example-key",
* keyRing: keyRing.id,
* });
* const dataset = new gcp.bigquery.Dataset("dataset", {
* datasetId: "example_dataset",
* friendlyName: "test",
* description: "This is a test description",
* location: "US",
* defaultTableExpirationMs: 3600000,
* defaultEncryptionConfiguration: {
* kmsKeyName: cryptoKey.id,
* },
* });
* ```
* ```python
* import pulumi
* import pulumi_gcp as gcp
* key_ring = gcp.kms.KeyRing("key_ring",
* name="example-keyring",
* location="us")
* crypto_key = gcp.kms.CryptoKey("crypto_key",
* name="example-key",
* key_ring=key_ring.id)
* dataset = gcp.bigquery.Dataset("dataset",
* dataset_id="example_dataset",
* friendly_name="test",
* description="This is a test description",
* location="US",
* default_table_expiration_ms=3600000,
* default_encryption_configuration=gcp.bigquery.DatasetDefaultEncryptionConfigurationArgs(
* kms_key_name=crypto_key.id,
* ))
* ```
* ```csharp
* using System.Collections.Generic;
* using System.Linq;
* using Pulumi;
* using Gcp = Pulumi.Gcp;
* return await Deployment.RunAsync(() =>
* {
* var keyRing = new Gcp.Kms.KeyRing("key_ring", new()
* {
* Name = "example-keyring",
* Location = "us",
* });
* var cryptoKey = new Gcp.Kms.CryptoKey("crypto_key", new()
* {
* Name = "example-key",
* KeyRing = keyRing.Id,
* });
* var dataset = new Gcp.BigQuery.Dataset("dataset", new()
* {
* DatasetId = "example_dataset",
* FriendlyName = "test",
* Description = "This is a test description",
* Location = "US",
* DefaultTableExpirationMs = 3600000,
* DefaultEncryptionConfiguration = new Gcp.BigQuery.Inputs.DatasetDefaultEncryptionConfigurationArgs
* {
* KmsKeyName = cryptoKey.Id,
* },
* });
* });
* ```
* ```go
* package main
* import (
* "github.com/pulumi/pulumi-gcp/sdk/v7/go/gcp/bigquery"
* "github.com/pulumi/pulumi-gcp/sdk/v7/go/gcp/kms"
* "github.com/pulumi/pulumi/sdk/v3/go/pulumi"
* )
* func main() {
* pulumi.Run(func(ctx *pulumi.Context) error {
* keyRing, err := kms.NewKeyRing(ctx, "key_ring", &kms.KeyRingArgs{
* Name: pulumi.String("example-keyring"),
* Location: pulumi.String("us"),
* })
* if err != nil {
* return err
* }
* cryptoKey, err := kms.NewCryptoKey(ctx, "crypto_key", &kms.CryptoKeyArgs{
* Name: pulumi.String("example-key"),
* KeyRing: keyRing.ID(),
* })
* if err != nil {
* return err
* }
* _, err = bigquery.NewDataset(ctx, "dataset", &bigquery.DatasetArgs{
* DatasetId: pulumi.String("example_dataset"),
* FriendlyName: pulumi.String("test"),
* Description: pulumi.String("This is a test description"),
* Location: pulumi.String("US"),
* DefaultTableExpirationMs: pulumi.Int(3600000),
* DefaultEncryptionConfiguration: &bigquery.DatasetDefaultEncryptionConfigurationArgs{
* KmsKeyName: cryptoKey.ID(),
* },
* })
* if err != nil {
* return err
* }
* return nil
* })
* }
* ```
* ```java
* package generated_program;
* import com.pulumi.Context;
* import com.pulumi.Pulumi;
* import com.pulumi.core.Output;
* import com.pulumi.gcp.kms.KeyRing;
* import com.pulumi.gcp.kms.KeyRingArgs;
* import com.pulumi.gcp.kms.CryptoKey;
* import com.pulumi.gcp.kms.CryptoKeyArgs;
* import com.pulumi.gcp.bigquery.Dataset;
* import com.pulumi.gcp.bigquery.DatasetArgs;
* import com.pulumi.gcp.bigquery.inputs.DatasetDefaultEncryptionConfigurationArgs;
* import java.util.List;
* import java.util.ArrayList;
* import java.util.Map;
* import java.io.File;
* import java.nio.file.Files;
* import java.nio.file.Paths;
* public class App {
* public static void main(String[] args) {
* Pulumi.run(App::stack);
* }
* public static void stack(Context ctx) {
* var keyRing = new KeyRing("keyRing", KeyRingArgs.builder()
* .name("example-keyring")
* .location("us")
* .build());
* var cryptoKey = new CryptoKey("cryptoKey", CryptoKeyArgs.builder()
* .name("example-key")
* .keyRing(keyRing.id())
* .build());
* var dataset = new Dataset("dataset", DatasetArgs.builder()
* .datasetId("example_dataset")
* .friendlyName("test")
* .description("This is a test description")
* .location("US")
* .defaultTableExpirationMs(3600000)
* .defaultEncryptionConfiguration(DatasetDefaultEncryptionConfigurationArgs.builder()
* .kmsKeyName(cryptoKey.id())
* .build())
* .build());
* }
* }
* ```
* ```yaml
* resources:
* dataset:
* type: gcp:bigquery:Dataset
* properties:
* datasetId: example_dataset
* friendlyName: test
* description: This is a test description
* location: US
* defaultTableExpirationMs: 3.6e+06
* defaultEncryptionConfiguration:
* kmsKeyName: ${cryptoKey.id}
* cryptoKey:
* type: gcp:kms:CryptoKey
* name: crypto_key
* properties:
* name: example-key
* keyRing: ${keyRing.id}
* keyRing:
* type: gcp:kms:KeyRing
* name: key_ring
* properties:
* name: example-keyring
* location: us
* ```
*
* ### Bigquery Dataset Authorized Dataset
*
* ```typescript
* import * as pulumi from "@pulumi/pulumi";
* import * as gcp from "@pulumi/gcp";
* const bqowner = new gcp.serviceaccount.Account("bqowner", {accountId: "bqowner"});
* const _public = new gcp.bigquery.Dataset("public", {
* datasetId: "public",
* friendlyName: "test",
* description: "This dataset is public",
* location: "EU",
* defaultTableExpirationMs: 3600000,
* labels: {
* env: "default",
* },
* accesses: [
* {
* role: "OWNER",
* userByEmail: bqowner.email,
* },
* {
* role: "READER",
* domain: "hashicorp.com",
* },
* ],
* });
* const dataset = new gcp.bigquery.Dataset("dataset", {
* datasetId: "private",
* friendlyName: "test",
* description: "This dataset is private",
* location: "EU",
* defaultTableExpirationMs: 3600000,
* labels: {
* env: "default",
* },
* accesses: [
* {
* role: "OWNER",
* userByEmail: bqowner.email,
* },
* {
* role: "READER",
* domain: "hashicorp.com",
* },
* {
* dataset: {
* dataset: {
* projectId: _public.project,
* datasetId: _public.datasetId,
* },
* targetTypes: ["VIEWS"],
* },
* },
* ],
* });
* ```
* ```python
* import pulumi
* import pulumi_gcp as gcp
* bqowner = gcp.serviceaccount.Account("bqowner", account_id="bqowner")
* public = gcp.bigquery.Dataset("public",
* dataset_id="public",
* friendly_name="test",
* description="This dataset is public",
* location="EU",
* default_table_expiration_ms=3600000,
* labels={
* "env": "default",
* },
* accesses=[
* gcp.bigquery.DatasetAccessArgs(
* role="OWNER",
* user_by_email=bqowner.email,
* ),
* gcp.bigquery.DatasetAccessArgs(
* role="READER",
* domain="hashicorp.com",
* ),
* ])
* dataset = gcp.bigquery.Dataset("dataset",
* dataset_id="private",
* friendly_name="test",
* description="This dataset is private",
* location="EU",
* default_table_expiration_ms=3600000,
* labels={
* "env": "default",
* },
* accesses=[
* gcp.bigquery.DatasetAccessArgs(
* role="OWNER",
* user_by_email=bqowner.email,
* ),
* gcp.bigquery.DatasetAccessArgs(
* role="READER",
* domain="hashicorp.com",
* ),
* gcp.bigquery.DatasetAccessArgs(
* dataset=gcp.bigquery.DatasetAccessDatasetArgs(
* dataset=gcp.bigquery.DatasetAccessDatasetDatasetArgs(
* project_id=public.project,
* dataset_id=public.dataset_id,
* ),
* target_types=["VIEWS"],
* ),
* ),
* ])
* ```
* ```csharp
* using System.Collections.Generic;
* using System.Linq;
* using Pulumi;
* using Gcp = Pulumi.Gcp;
* return await Deployment.RunAsync(() =>
* {
* var bqowner = new Gcp.ServiceAccount.Account("bqowner", new()
* {
* AccountId = "bqowner",
* });
* var @public = new Gcp.BigQuery.Dataset("public", new()
* {
* DatasetId = "public",
* FriendlyName = "test",
* Description = "This dataset is public",
* Location = "EU",
* DefaultTableExpirationMs = 3600000,
* Labels =
* {
* { "env", "default" },
* },
* Accesses = new[]
* {
* new Gcp.BigQuery.Inputs.DatasetAccessArgs
* {
* Role = "OWNER",
* UserByEmail = bqowner.Email,
* },
* new Gcp.BigQuery.Inputs.DatasetAccessArgs
* {
* Role = "READER",
* Domain = "hashicorp.com",
* },
* },
* });
* var dataset = new Gcp.BigQuery.Dataset("dataset", new()
* {
* DatasetId = "private",
* FriendlyName = "test",
* Description = "This dataset is private",
* Location = "EU",
* DefaultTableExpirationMs = 3600000,
* Labels =
* {
* { "env", "default" },
* },
* Accesses = new[]
* {
* new Gcp.BigQuery.Inputs.DatasetAccessArgs
* {
* Role = "OWNER",
* UserByEmail = bqowner.Email,
* },
* new Gcp.BigQuery.Inputs.DatasetAccessArgs
* {
* Role = "READER",
* Domain = "hashicorp.com",
* },
* new Gcp.BigQuery.Inputs.DatasetAccessArgs
* {
* Dataset = new Gcp.BigQuery.Inputs.DatasetAccessDatasetArgs
* {
* Dataset = new Gcp.BigQuery.Inputs.DatasetAccessDatasetDatasetArgs
* {
* ProjectId = @public.Project,
* DatasetId = @public.DatasetId,
* },
* TargetTypes = new[]
* {
* "VIEWS",
* },
* },
* },
* },
* });
* });
* ```
* ```go
* package main
* import (
* "github.com/pulumi/pulumi-gcp/sdk/v7/go/gcp/bigquery"
* "github.com/pulumi/pulumi-gcp/sdk/v7/go/gcp/serviceaccount"
* "github.com/pulumi/pulumi/sdk/v3/go/pulumi"
* )
* func main() {
* pulumi.Run(func(ctx *pulumi.Context) error {
* bqowner, err := serviceaccount.NewAccount(ctx, "bqowner", &serviceaccount.AccountArgs{
* AccountId: pulumi.String("bqowner"),
* })
* if err != nil {
* return err
* }
* public, err := bigquery.NewDataset(ctx, "public", &bigquery.DatasetArgs{
* DatasetId: pulumi.String("public"),
* FriendlyName: pulumi.String("test"),
* Description: pulumi.String("This dataset is public"),
* Location: pulumi.String("EU"),
* DefaultTableExpirationMs: pulumi.Int(3600000),
* Labels: pulumi.StringMap{
* "env": pulumi.String("default"),
* },
* Accesses: bigquery.DatasetAccessTypeArray{
* &bigquery.DatasetAccessTypeArgs{
* Role: pulumi.String("OWNER"),
* UserByEmail: bqowner.Email,
* },
* &bigquery.DatasetAccessTypeArgs{
* Role: pulumi.String("READER"),
* Domain: pulumi.String("hashicorp.com"),
* },
* },
* })
* if err != nil {
* return err
* }
* _, err = bigquery.NewDataset(ctx, "dataset", &bigquery.DatasetArgs{
* DatasetId: pulumi.String("private"),
* FriendlyName: pulumi.String("test"),
* Description: pulumi.String("This dataset is private"),
* Location: pulumi.String("EU"),
* DefaultTableExpirationMs: pulumi.Int(3600000),
* Labels: pulumi.StringMap{
* "env": pulumi.String("default"),
* },
* Accesses: bigquery.DatasetAccessTypeArray{
* &bigquery.DatasetAccessTypeArgs{
* Role: pulumi.String("OWNER"),
* UserByEmail: bqowner.Email,
* },
* &bigquery.DatasetAccessTypeArgs{
* Role: pulumi.String("READER"),
* Domain: pulumi.String("hashicorp.com"),
* },
* &bigquery.DatasetAccessTypeArgs{
* Dataset: &bigquery.DatasetAccessDatasetArgs{
* Dataset: &bigquery.DatasetAccessDatasetDatasetArgs{
* ProjectId: public.Project,
* DatasetId: public.DatasetId,
* },
* TargetTypes: pulumi.StringArray{
* pulumi.String("VIEWS"),
* },
* },
* },
* },
* })
* if err != nil {
* return err
* }
* return nil
* })
* }
* ```
* ```java
* package generated_program;
* import com.pulumi.Context;
* import com.pulumi.Pulumi;
* import com.pulumi.core.Output;
* import com.pulumi.gcp.serviceaccount.Account;
* import com.pulumi.gcp.serviceaccount.AccountArgs;
* import com.pulumi.gcp.bigquery.Dataset;
* import com.pulumi.gcp.bigquery.DatasetArgs;
* import com.pulumi.gcp.bigquery.inputs.DatasetAccessArgs;
* import com.pulumi.gcp.bigquery.inputs.DatasetAccessDatasetArgs;
* import com.pulumi.gcp.bigquery.inputs.DatasetAccessDatasetDatasetArgs;
* import java.util.List;
* import java.util.ArrayList;
* import java.util.Map;
* import java.io.File;
* import java.nio.file.Files;
* import java.nio.file.Paths;
* public class App {
* public static void main(String[] args) {
* Pulumi.run(App::stack);
* }
* public static void stack(Context ctx) {
* var bqowner = new Account("bqowner", AccountArgs.builder()
* .accountId("bqowner")
* .build());
* var public_ = new Dataset("public", DatasetArgs.builder()
* .datasetId("public")
* .friendlyName("test")
* .description("This dataset is public")
* .location("EU")
* .defaultTableExpirationMs(3600000)
* .labels(Map.of("env", "default"))
* .accesses(
* DatasetAccessArgs.builder()
* .role("OWNER")
* .userByEmail(bqowner.email())
* .build(),
* DatasetAccessArgs.builder()
* .role("READER")
* .domain("hashicorp.com")
* .build())
* .build());
* var dataset = new Dataset("dataset", DatasetArgs.builder()
* .datasetId("private")
* .friendlyName("test")
* .description("This dataset is private")
* .location("EU")
* .defaultTableExpirationMs(3600000)
* .labels(Map.of("env", "default"))
* .accesses(
* DatasetAccessArgs.builder()
* .role("OWNER")
* .userByEmail(bqowner.email())
* .build(),
* DatasetAccessArgs.builder()
* .role("READER")
* .domain("hashicorp.com")
* .build(),
* DatasetAccessArgs.builder()
* .dataset(DatasetAccessDatasetArgs.builder()
* .dataset(DatasetAccessDatasetDatasetArgs.builder()
* .projectId(public_.project())
* .datasetId(public_.datasetId())
* .build())
* .targetTypes("VIEWS")
* .build())
* .build())
* .build());
* }
* }
* ```
* ```yaml
* resources:
* public:
* type: gcp:bigquery:Dataset
* properties:
* datasetId: public
* friendlyName: test
* description: This dataset is public
* location: EU
* defaultTableExpirationMs: 3.6e+06
* labels:
* env: default
* accesses:
* - role: OWNER
* userByEmail: ${bqowner.email}
* - role: READER
* domain: hashicorp.com
* dataset:
* type: gcp:bigquery:Dataset
* properties:
* datasetId: private
* friendlyName: test
* description: This dataset is private
* location: EU
* defaultTableExpirationMs: 3.6e+06
* labels:
* env: default
* accesses:
* - role: OWNER
* userByEmail: ${bqowner.email}
* - role: READER
* domain: hashicorp.com
* - dataset:
* dataset:
* projectId: ${public.project}
* datasetId: ${public.datasetId}
* targetTypes:
* - VIEWS
* bqowner:
* type: gcp:serviceaccount:Account
* properties:
* accountId: bqowner
* ```
*
* ### Bigquery Dataset Authorized Routine
*
* ```typescript
* import * as pulumi from "@pulumi/pulumi";
* import * as gcp from "@pulumi/gcp";
* const _public = new gcp.bigquery.Dataset("public", {
* datasetId: "public_dataset",
* description: "This dataset is public",
* });
* const publicRoutine = new gcp.bigquery.Routine("public", {
* datasetId: _public.datasetId,
* routineId: "public_routine",
* routineType: "TABLE_VALUED_FUNCTION",
* language: "SQL",
* definitionBody: "SELECT 1 + value AS value\n",
* arguments: [{
* name: "value",
* argumentKind: "FIXED_TYPE",
* dataType: JSON.stringify({
* typeKind: "INT64",
* }),
* }],
* returnTableType: JSON.stringify({
* columns: [{
* name: "value",
* type: {
* typeKind: "INT64",
* },
* }],
* }),
* });
* const _private = new gcp.bigquery.Dataset("private", {
* datasetId: "private_dataset",
* description: "This dataset is private",
* accesses: [
* {
* role: "OWNER",
* userByEmail: "[email protected]",
* },
* {
* routine: {
* projectId: publicRoutine.project,
* datasetId: publicRoutine.datasetId,
* routineId: publicRoutine.routineId,
* },
* },
* ],
* });
* ```
* ```python
* import pulumi
* import json
* import pulumi_gcp as gcp
* public = gcp.bigquery.Dataset("public",
* dataset_id="public_dataset",
* description="This dataset is public")
* public_routine = gcp.bigquery.Routine("public",
* dataset_id=public.dataset_id,
* routine_id="public_routine",
* routine_type="TABLE_VALUED_FUNCTION",
* language="SQL",
* definition_body="SELECT 1 + value AS value\n",
* arguments=[gcp.bigquery.RoutineArgumentArgs(
* name="value",
* argument_kind="FIXED_TYPE",
* data_type=json.dumps({
* "typeKind": "INT64",
* }),
* )],
* return_table_type=json.dumps({
* "columns": [{
* "name": "value",
* "type": {
* "typeKind": "INT64",
* },
* }],
* }))
* private = gcp.bigquery.Dataset("private",
* dataset_id="private_dataset",
* description="This dataset is private",
* accesses=[
* gcp.bigquery.DatasetAccessArgs(
* role="OWNER",
* user_by_email="[email protected]",
* ),
* gcp.bigquery.DatasetAccessArgs(
* routine=gcp.bigquery.DatasetAccessRoutineArgs(
* project_id=public_routine.project,
* dataset_id=public_routine.dataset_id,
* routine_id=public_routine.routine_id,
* ),
* ),
* ])
* ```
* ```csharp
* using System.Collections.Generic;
* using System.Linq;
* using System.Text.Json;
* using Pulumi;
* using Gcp = Pulumi.Gcp;
* return await Deployment.RunAsync(() =>
* {
* var @public = new Gcp.BigQuery.Dataset("public", new()
* {
* DatasetId = "public_dataset",
* Description = "This dataset is public",
* });
* var publicRoutine = new Gcp.BigQuery.Routine("public", new()
* {
* DatasetId = @public.DatasetId,
* RoutineId = "public_routine",
* RoutineType = "TABLE_VALUED_FUNCTION",
* Language = "SQL",
* DefinitionBody = @"SELECT 1 + value AS value
* ",
* Arguments = new[]
* {
* new Gcp.BigQuery.Inputs.RoutineArgumentArgs
* {
* Name = "value",
* ArgumentKind = "FIXED_TYPE",
* DataType = JsonSerializer.Serialize(new Dictionary
* {
* ["typeKind"] = "INT64",
* }),
* },
* },
* ReturnTableType = JsonSerializer.Serialize(new Dictionary
* {
* ["columns"] = new[]
* {
* new Dictionary
* {
* ["name"] = "value",
* ["type"] = new Dictionary
* {
* ["typeKind"] = "INT64",
* },
* },
* },
* }),
* });
* var @private = new Gcp.BigQuery.Dataset("private", new()
* {
* DatasetId = "private_dataset",
* Description = "This dataset is private",
* Accesses = new[]
* {
* new Gcp.BigQuery.Inputs.DatasetAccessArgs
* {
* Role = "OWNER",
* UserByEmail = "[email protected]",
* },
* new Gcp.BigQuery.Inputs.DatasetAccessArgs
* {
* Routine = new Gcp.BigQuery.Inputs.DatasetAccessRoutineArgs
* {
* ProjectId = publicRoutine.Project,
* DatasetId = publicRoutine.DatasetId,
* RoutineId = publicRoutine.RoutineId,
* },
* },
* },
* });
* });
* ```
* ```go
* package main
* import (
* "encoding/json"
* "github.com/pulumi/pulumi-gcp/sdk/v7/go/gcp/bigquery"
* "github.com/pulumi/pulumi/sdk/v3/go/pulumi"
* )
* func main() {
* pulumi.Run(func(ctx *pulumi.Context) error {
* public, err := bigquery.NewDataset(ctx, "public", &bigquery.DatasetArgs{
* DatasetId: pulumi.String("public_dataset"),
* Description: pulumi.String("This dataset is public"),
* })
* if err != nil {
* return err
* }
* tmpJSON0, err := json.Marshal(map[string]interface{}{
* "typeKind": "INT64",
* })
* if err != nil {
* return err
* }
* json0 := string(tmpJSON0)
* tmpJSON1, err := json.Marshal(map[string]interface{}{
* "columns": []map[string]interface{}{
* map[string]interface{}{
* "name": "value",
* "type": map[string]interface{}{
* "typeKind": "INT64",
* },
* },
* },
* })
* if err != nil {
* return err
* }
* json1 := string(tmpJSON1)
* publicRoutine, err := bigquery.NewRoutine(ctx, "public", &bigquery.RoutineArgs{
* DatasetId: public.DatasetId,
* RoutineId: pulumi.String("public_routine"),
* RoutineType: pulumi.String("TABLE_VALUED_FUNCTION"),
* Language: pulumi.String("SQL"),
* DefinitionBody: pulumi.String("SELECT 1 + value AS value\n"),
* Arguments: bigquery.RoutineArgumentArray{
* &bigquery.RoutineArgumentArgs{
* Name: pulumi.String("value"),
* ArgumentKind: pulumi.String("FIXED_TYPE"),
* DataType: pulumi.String(json0),
* },
* },
* ReturnTableType: pulumi.String(json1),
* })
* if err != nil {
* return err
* }
* _, err = bigquery.NewDataset(ctx, "private", &bigquery.DatasetArgs{
* DatasetId: pulumi.String("private_dataset"),
* Description: pulumi.String("This dataset is private"),
* Accesses: bigquery.DatasetAccessTypeArray{
* &bigquery.DatasetAccessTypeArgs{
* Role: pulumi.String("OWNER"),
* UserByEmail: pulumi.String("[email protected]"),
* },
* &bigquery.DatasetAccessTypeArgs{
* Routine: &bigquery.DatasetAccessRoutineArgs{
* ProjectId: publicRoutine.Project,
* DatasetId: publicRoutine.DatasetId,
* RoutineId: publicRoutine.RoutineId,
* },
* },
* },
* })
* if err != nil {
* return err
* }
* return nil
* })
* }
* ```
* ```java
* package generated_program;
* import com.pulumi.Context;
* import com.pulumi.Pulumi;
* import com.pulumi.core.Output;
* import com.pulumi.gcp.bigquery.Dataset;
* import com.pulumi.gcp.bigquery.DatasetArgs;
* import com.pulumi.gcp.bigquery.Routine;
* import com.pulumi.gcp.bigquery.RoutineArgs;
* import com.pulumi.gcp.bigquery.inputs.RoutineArgumentArgs;
* import com.pulumi.gcp.bigquery.inputs.DatasetAccessArgs;
* import com.pulumi.gcp.bigquery.inputs.DatasetAccessRoutineArgs;
* import static com.pulumi.codegen.internal.Serialization.*;
* import java.util.List;
* import java.util.ArrayList;
* import java.util.Map;
* import java.io.File;
* import java.nio.file.Files;
* import java.nio.file.Paths;
* public class App {
* public static void main(String[] args) {
* Pulumi.run(App::stack);
* }
* public static void stack(Context ctx) {
* var public_ = new Dataset("public", DatasetArgs.builder()
* .datasetId("public_dataset")
* .description("This dataset is public")
* .build());
* var publicRoutine = new Routine("publicRoutine", RoutineArgs.builder()
* .datasetId(public_.datasetId())
* .routineId("public_routine")
* .routineType("TABLE_VALUED_FUNCTION")
* .language("SQL")
* .definitionBody("""
* SELECT 1 + value AS value
* """)
* .arguments(RoutineArgumentArgs.builder()
* .name("value")
* .argumentKind("FIXED_TYPE")
* .dataType(serializeJson(
* jsonObject(
* jsonProperty("typeKind", "INT64")
* )))
* .build())
* .returnTableType(serializeJson(
* jsonObject(
* jsonProperty("columns", jsonArray(jsonObject(
* jsonProperty("name", "value"),
* jsonProperty("type", jsonObject(
* jsonProperty("typeKind", "INT64")
* ))
* )))
* )))
* .build());
* var private_ = new Dataset("private", DatasetArgs.builder()
* .datasetId("private_dataset")
* .description("This dataset is private")
* .accesses(
* DatasetAccessArgs.builder()
* .role("OWNER")
* .userByEmail("[email protected]")
* .build(),
* DatasetAccessArgs.builder()
* .routine(DatasetAccessRoutineArgs.builder()
* .projectId(publicRoutine.project())
* .datasetId(publicRoutine.datasetId())
* .routineId(publicRoutine.routineId())
* .build())
* .build())
* .build());
* }
* }
* ```
* ```yaml
* resources:
* public:
* type: gcp:bigquery:Dataset
* properties:
* datasetId: public_dataset
* description: This dataset is public
* publicRoutine:
* type: gcp:bigquery:Routine
* name: public
* properties:
* datasetId: ${public.datasetId}
* routineId: public_routine
* routineType: TABLE_VALUED_FUNCTION
* language: SQL
* definitionBody: |
* SELECT 1 + value AS value
* arguments:
* - name: value
* argumentKind: FIXED_TYPE
* dataType:
* fn::toJSON:
* typeKind: INT64
* returnTableType:
* fn::toJSON:
* columns:
* - name: value
* type:
* typeKind: INT64
* private:
* type: gcp:bigquery:Dataset
* properties:
* datasetId: private_dataset
* description: This dataset is private
* accesses:
* - role: OWNER
* userByEmail: [email protected]
* - routine:
* projectId: ${publicRoutine.project}
* datasetId: ${publicRoutine.datasetId}
* routineId: ${publicRoutine.routineId}
* ```
*
* ### Bigquery Dataset External Reference Aws
*
* ```typescript
* import * as pulumi from "@pulumi/pulumi";
* import * as gcp from "@pulumi/gcp";
* const dataset = new gcp.bigquery.Dataset("dataset", {
* datasetId: "example_dataset",
* friendlyName: "test",
* description: "This is a test description",
* location: "aws-us-east-1",
* externalDatasetReference: {
* externalSource: "aws-glue://arn:aws:glue:us-east-1:999999999999:database/database",
* connection: "projects/project/locations/aws-us-east-1/connections/connection",
* },
* });
* ```
* ```python
* import pulumi
* import pulumi_gcp as gcp
* dataset = gcp.bigquery.Dataset("dataset",
* dataset_id="example_dataset",
* friendly_name="test",
* description="This is a test description",
* location="aws-us-east-1",
* external_dataset_reference=gcp.bigquery.DatasetExternalDatasetReferenceArgs(
* external_source="aws-glue://arn:aws:glue:us-east-1:999999999999:database/database",
* connection="projects/project/locations/aws-us-east-1/connections/connection",
* ))
* ```
* ```csharp
* using System.Collections.Generic;
* using System.Linq;
* using Pulumi;
* using Gcp = Pulumi.Gcp;
* return await Deployment.RunAsync(() =>
* {
* var dataset = new Gcp.BigQuery.Dataset("dataset", new()
* {
* DatasetId = "example_dataset",
* FriendlyName = "test",
* Description = "This is a test description",
* Location = "aws-us-east-1",
* ExternalDatasetReference = new Gcp.BigQuery.Inputs.DatasetExternalDatasetReferenceArgs
* {
* ExternalSource = "aws-glue://arn:aws:glue:us-east-1:999999999999:database/database",
* Connection = "projects/project/locations/aws-us-east-1/connections/connection",
* },
* });
* });
* ```
* ```go
* package main
* import (
* "github.com/pulumi/pulumi-gcp/sdk/v7/go/gcp/bigquery"
* "github.com/pulumi/pulumi/sdk/v3/go/pulumi"
* )
* func main() {
* pulumi.Run(func(ctx *pulumi.Context) error {
* _, err := bigquery.NewDataset(ctx, "dataset", &bigquery.DatasetArgs{
* DatasetId: pulumi.String("example_dataset"),
* FriendlyName: pulumi.String("test"),
* Description: pulumi.String("This is a test description"),
* Location: pulumi.String("aws-us-east-1"),
* ExternalDatasetReference: &bigquery.DatasetExternalDatasetReferenceArgs{
* ExternalSource: pulumi.String("aws-glue://arn:aws:glue:us-east-1:999999999999:database/database"),
* Connection: pulumi.String("projects/project/locations/aws-us-east-1/connections/connection"),
* },
* })
* if err != nil {
* return err
* }
* return nil
* })
* }
* ```
* ```java
* package generated_program;
* import com.pulumi.Context;
* import com.pulumi.Pulumi;
* import com.pulumi.core.Output;
* import com.pulumi.gcp.bigquery.Dataset;
* import com.pulumi.gcp.bigquery.DatasetArgs;
* import com.pulumi.gcp.bigquery.inputs.DatasetExternalDatasetReferenceArgs;
* import java.util.List;
* import java.util.ArrayList;
* import java.util.Map;
* import java.io.File;
* import java.nio.file.Files;
* import java.nio.file.Paths;
* public class App {
* public static void main(String[] args) {
* Pulumi.run(App::stack);
* }
* public static void stack(Context ctx) {
* var dataset = new Dataset("dataset", DatasetArgs.builder()
* .datasetId("example_dataset")
* .friendlyName("test")
* .description("This is a test description")
* .location("aws-us-east-1")
* .externalDatasetReference(DatasetExternalDatasetReferenceArgs.builder()
* .externalSource("aws-glue://arn:aws:glue:us-east-1:999999999999:database/database")
* .connection("projects/project/locations/aws-us-east-1/connections/connection")
* .build())
* .build());
* }
* }
* ```
* ```yaml
* resources:
* dataset:
* type: gcp:bigquery:Dataset
* properties:
* datasetId: example_dataset
* friendlyName: test
* description: This is a test description
* location: aws-us-east-1
* externalDatasetReference:
* externalSource: aws-glue://arn:aws:glue:us-east-1:999999999999:database/database
* connection: projects/project/locations/aws-us-east-1/connections/connection
* ```
*
* ## Import
* Dataset can be imported using any of these accepted formats:
* * `projects/{{project}}/datasets/{{dataset_id}}`
* * `{{project}}/{{dataset_id}}`
* * `{{dataset_id}}`
* When using the `pulumi import` command, Dataset can be imported using one of the formats above. For example:
* ```sh
* $ pulumi import gcp:bigquery/dataset:Dataset default projects/{{project}}/datasets/{{dataset_id}}
* ```
* ```sh
* $ pulumi import gcp:bigquery/dataset:Dataset default {{project}}/{{dataset_id}}
* ```
* ```sh
* $ pulumi import gcp:bigquery/dataset:Dataset default {{dataset_id}}
* ```
*/
public class Dataset internal constructor(
override val javaResource: com.pulumi.gcp.bigquery.Dataset,
) : KotlinCustomResource(javaResource, DatasetMapper) {
/**
* An array of objects that define dataset access for one or more entities.
* Structure is documented below.
*/
public val accesses: Output>
get() = javaResource.accesses().applyValue({ args0 ->
args0.map({ args0 ->
args0.let({ args0 ->
datasetAccessToKotlin(args0)
})
})
})
/**
* The time when this dataset was created, in milliseconds since the
* epoch.
*/
public val creationTime: Output
get() = javaResource.creationTime().applyValue({ args0 -> args0 })
/**
* A unique ID for this dataset, without the project name. The ID
* must contain only letters (a-z, A-Z), numbers (0-9), or
* underscores (_). The maximum length is 1,024 characters.
* - - -
*/
public val datasetId: Output
get() = javaResource.datasetId().applyValue({ args0 -> args0 })
/**
* Defines the default collation specification of future tables created
* in the dataset. If a table is created in this dataset without table-level
* default collation, then the table inherits the dataset default collation,
* which is applied to the string fields that do not have explicit collation
* specified. A change to this field affects only tables created afterwards,
* and does not alter the existing tables.
* The following values are supported:
* - 'und:ci': undetermined locale, case insensitive.
* - '': empty string. Default to case-sensitive behavior.
*/
public val defaultCollation: Output
get() = javaResource.defaultCollation().applyValue({ args0 -> args0 })
/**
* The default encryption key for all tables in the dataset. Once this property is set,
* all newly-created partitioned tables in the dataset will have encryption key set to
* this value, unless table creation request (or query) overrides the key.
* Structure is documented below.
*/
public val defaultEncryptionConfiguration: Output?
get() = javaResource.defaultEncryptionConfiguration().applyValue({ args0 ->
args0.map({ args0 ->
args0.let({ args0 -> datasetDefaultEncryptionConfigurationToKotlin(args0) })
}).orElse(null)
})
/**
* 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.
*/
public val defaultPartitionExpirationMs: Output?
get() = javaResource.defaultPartitionExpirationMs().applyValue({ args0 ->
args0.map({ args0 ->
args0
}).orElse(null)
})
/**
* 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.
*/
public val defaultTableExpirationMs: Output?
get() = javaResource.defaultTableExpirationMs().applyValue({ args0 ->
args0.map({ args0 ->
args0
}).orElse(null)
})
/**
* If set to `true`, delete all the tables in the
* dataset when destroying the resource; otherwise,
* destroying the resource will fail if tables are present.
*/
public val deleteContentsOnDestroy: Output?
get() = javaResource.deleteContentsOnDestroy().applyValue({ args0 ->
args0.map({ args0 ->
args0
}).orElse(null)
})
/**
* A user-friendly description of the dataset
*/
public val description: Output?
get() = javaResource.description().applyValue({ args0 ->
args0.map({ args0 ->
args0
}).orElse(null)
})
/**
* All of labels (key/value pairs) present on the resource in GCP, including the labels configured through Pulumi, other clients and services.
*/
public val effectiveLabels: Output
© 2015 - 2024 Weber Informatics LLC | Privacy Policy