Package com.google.cloud.asset.v1p7beta1

Interface BigQueryDestinationOrBuilder

  • All Superinterfaces:
    com.google.protobuf.MessageLiteOrBuilder, com.google.protobuf.MessageOrBuilder
    All Known Implementing Classes:
    BigQueryDestination, BigQueryDestination.Builder
    public interface BigQueryDestinationOrBuilder
extends com.google.protobuf.MessageOrBuilder

    • Method Summary

      All Methods Instance Methods Abstract Methods 
      Modifier and Type Method Description
      String getDataset()
      Required.
      com.google.protobuf.ByteString getDatasetBytes()
      Required.
      boolean getForce()
      If the destination table already exists and this flag is `TRUE`, the table will be overwritten by the contents of assets snapshot.
      PartitionSpec getPartitionSpec()
      [partition_spec] determines whether to export to partitioned table(s) and how to partition the data.
      PartitionSpecOrBuilder getPartitionSpecOrBuilder()
      [partition_spec] determines whether to export to partitioned table(s) and how to partition the data.
      boolean getSeparateTablesPerAssetType()
      If this flag is `TRUE`, the snapshot results will be written to one or multiple tables, each of which contains results of one asset type.
      String getTable()
      Required.
      com.google.protobuf.ByteString getTableBytes()
      Required.
      boolean hasPartitionSpec()
      [partition_spec] determines whether to export to partitioned table(s) and how to partition the data.

      • Methods inherited from interface com.google.protobuf.MessageLiteOrBuilder

        isInitialized

      • Methods inherited from interface com.google.protobuf.MessageOrBuilder

        findInitializationErrors, getAllFields, getDefaultInstanceForType, getDescriptorForType, getField, getInitializationErrorString, getOneofFieldDescriptor, getRepeatedField, getRepeatedFieldCount, getUnknownFields, hasField, hasOneof

    • Method Detail

      • getDataset

        String getDataset()
         Required. The BigQuery dataset in format
 "projects/projectId/datasets/datasetId", to which the snapshot result
 should be exported. If this dataset does not exist, the export call returns
 an INVALID_ARGUMENT error.
        string dataset = 1 [(.google.api.field_behavior) = REQUIRED];
        Returns:
        The dataset.

      • getDatasetBytes

        com.google.protobuf.ByteString getDatasetBytes()
         Required. The BigQuery dataset in format
 "projects/projectId/datasets/datasetId", to which the snapshot result
 should be exported. If this dataset does not exist, the export call returns
 an INVALID_ARGUMENT error.
        string dataset = 1 [(.google.api.field_behavior) = REQUIRED];
        Returns:
        The bytes for dataset.

      • getTable

        String getTable()
         Required. The BigQuery table to which the snapshot result should be
 written. If this table does not exist, a new table with the given name
 will be created.
        string table = 2 [(.google.api.field_behavior) = REQUIRED];
        Returns:
        The table.

      • getTableBytes

        com.google.protobuf.ByteString getTableBytes()
         Required. The BigQuery table to which the snapshot result should be
 written. If this table does not exist, a new table with the given name
 will be created.
        string table = 2 [(.google.api.field_behavior) = REQUIRED];
        Returns:
        The bytes for table.

      • getForce

        boolean getForce()
         If the destination table already exists and this flag is `TRUE`, the
 table will be overwritten by the contents of assets snapshot. If the flag
 is `FALSE` or unset and the destination table already exists, the export
 call returns an INVALID_ARGUMEMT error.
        bool force = 3;
        Returns:
        The force.

      • hasPartitionSpec

        boolean hasPartitionSpec()
         [partition_spec] determines whether to export to partitioned table(s) and
 how to partition the data.

 If [partition_spec] is unset or [partition_spec.partition_key] is unset or
 `PARTITION_KEY_UNSPECIFIED`, the snapshot results will be exported to
 non-partitioned table(s). [force] will decide whether to overwrite existing
 table(s).

 If [partition_spec] is specified. First, the snapshot results will be
 written to partitioned table(s) with two additional timestamp columns,
 readTime and requestTime, one of which will be the partition key. Secondly,
 in the case when any destination table already exists, it will first try to
 update existing table's schema as necessary by appending additional
 columns. Then, if [force] is `TRUE`, the corresponding partition will be
 overwritten by the snapshot results (data in different partitions will
 remain intact); if [force] is unset or `FALSE`, it will append the data. An
 error will be returned if the schema update or data appension fails.
        .google.cloud.asset.v1p7beta1.PartitionSpec partition_spec = 4;
        Returns:
        Whether the partitionSpec field is set.

      • getPartitionSpec

        PartitionSpec getPartitionSpec()
         [partition_spec] determines whether to export to partitioned table(s) and
 how to partition the data.

 If [partition_spec] is unset or [partition_spec.partition_key] is unset or
 `PARTITION_KEY_UNSPECIFIED`, the snapshot results will be exported to
 non-partitioned table(s). [force] will decide whether to overwrite existing
 table(s).

 If [partition_spec] is specified. First, the snapshot results will be
 written to partitioned table(s) with two additional timestamp columns,
 readTime and requestTime, one of which will be the partition key. Secondly,
 in the case when any destination table already exists, it will first try to
 update existing table's schema as necessary by appending additional
 columns. Then, if [force] is `TRUE`, the corresponding partition will be
 overwritten by the snapshot results (data in different partitions will
 remain intact); if [force] is unset or `FALSE`, it will append the data. An
 error will be returned if the schema update or data appension fails.
        .google.cloud.asset.v1p7beta1.PartitionSpec partition_spec = 4;
        Returns:
        The partitionSpec.

      • getPartitionSpecOrBuilder

        PartitionSpecOrBuilder getPartitionSpecOrBuilder()
         [partition_spec] determines whether to export to partitioned table(s) and
 how to partition the data.

 If [partition_spec] is unset or [partition_spec.partition_key] is unset or
 `PARTITION_KEY_UNSPECIFIED`, the snapshot results will be exported to
 non-partitioned table(s). [force] will decide whether to overwrite existing
 table(s).

 If [partition_spec] is specified. First, the snapshot results will be
 written to partitioned table(s) with two additional timestamp columns,
 readTime and requestTime, one of which will be the partition key. Secondly,
 in the case when any destination table already exists, it will first try to
 update existing table's schema as necessary by appending additional
 columns. Then, if [force] is `TRUE`, the corresponding partition will be
 overwritten by the snapshot results (data in different partitions will
 remain intact); if [force] is unset or `FALSE`, it will append the data. An
 error will be returned if the schema update or data appension fails.
        .google.cloud.asset.v1p7beta1.PartitionSpec partition_spec = 4;

      • getSeparateTablesPerAssetType

        boolean getSeparateTablesPerAssetType()
         If this flag is `TRUE`, the snapshot results will be written to one or
 multiple tables, each of which contains results of one asset type. The
 [force] and [partition_spec] fields will apply to each of them.

 Field [table] will be concatenated with "_" and the asset type names (see
 https://cloud.google.com/asset-inventory/docs/supported-asset-types for
 supported asset types) to construct per-asset-type table names, in which
 all non-alphanumeric characters like "." and "/" will be substituted by
 "_". Example: if field [table] is "mytable" and snapshot results
 contain "storage.googleapis.com/Bucket" assets, the corresponding table
 name will be "mytable_storage_googleapis_com_Bucket". If any of these
 tables does not exist, a new table with the concatenated name will be
 created.

 When [content_type] in the ExportAssetsRequest is `RESOURCE`, the schema of
 each table will include RECORD-type columns mapped to the nested fields in
 the Asset.resource.data field of that asset type (up to the 15 nested level
 BigQuery supports
 (https://cloud.google.com/bigquery/docs/nested-repeated#limitations)). The
 fields in >15 nested levels will be stored in JSON format string as a child
 column of its parent RECORD column.

 If error occurs when exporting to any table, the whole export call will
 return an error but the export results that already succeed will persist.
 Example: if exporting to table_type_A succeeds when exporting to
 table_type_B fails during one export call, the results in table_type_A will
 persist and there will not be partial results persisting in a table.
        bool separate_tables_per_asset_type = 5;
        Returns:
        The separateTablesPerAssetType.