Package software.amazon.awscdk.services.athena

Class CfnDataCatalogProps.Builder

java.lang.Object
software.amazon.awscdk.services.athena.CfnDataCatalogProps.Builder
All Implemented Interfaces:
software.amazon.jsii.Builder<CfnDataCatalogProps>
Enclosing interface:
CfnDataCatalogProps
@Stability(Stable) public static final class CfnDataCatalogProps.Builder extends Object implements software.amazon.jsii.Builder<CfnDataCatalogProps>
A builder for CfnDataCatalogProps

  • Constructor Details

    • Builder

      public Builder()

  • Method Details

    • name

      @Stability(Stable) public CfnDataCatalogProps.Builder name(String name)
      Sets the value of CfnDataCatalogProps.getName()
      Parameters:
      name - The name of the data catalog. This parameter is required. The catalog name must be unique for the AWS account and can use a maximum of 128 alphanumeric, underscore, at sign, or hyphen characters.
      Returns:
      this

    • type

      @Stability(Stable) public CfnDataCatalogProps.Builder type(String type)
      Sets the value of CfnDataCatalogProps.getType()
      Parameters:
      type - The type of data catalog: LAMBDA for a federated catalog, GLUE for AWS Glue Catalog, or HIVE for an external hive metastore. This parameter is required.
      Returns:
      this

    • connectionType

      @Stability(Stable) public CfnDataCatalogProps.Builder connectionType(String connectionType)
      Sets the value of CfnDataCatalogProps.getConnectionType()
      Parameters:
      connectionType - The type of connection for a FEDERATED data catalog (for example, REDSHIFT , MYSQL , or SQLSERVER ). For information about individual connectors, see Available data source connectors .
      Returns:
      this

    • description

      @Stability(Stable) public CfnDataCatalogProps.Builder description(String description)
      Sets the value of CfnDataCatalogProps.getDescription()
      Parameters:
      description - A description of the data catalog.
      Returns:
      this

    • error

      @Stability(Stable) public CfnDataCatalogProps.Builder error(String error)
      Sets the value of CfnDataCatalogProps.getError()
      Parameters:
      error - Text of the error that occurred during data catalog creation or deletion.
      Returns:
      this

    • parameters

      @Stability(Stable) public CfnDataCatalogProps.Builder parameters(Map<String,String> parameters)
      Sets the value of CfnDataCatalogProps.getParameters()
      Parameters:
      parameters - Specifies the Lambda function or functions to use for creating the data catalog. This is a mapping whose values depend on the catalog type.

      • For the HIVE data catalog type, use the following syntax. The metadata-function parameter is required. The sdk-version parameter is optional and defaults to the currently supported version.

      metadata-function= *lambda_arn* , sdk-version= *version_number*

      • For the LAMBDA data catalog type, use one of the following sets of required parameters, but not both.
      • If you have one Lambda function that processes metadata and another for reading the actual data, use the following syntax. Both parameters are required.

      metadata-function= *lambda_arn* , record-function= *lambda_arn*

      • If you have a composite Lambda function that processes both metadata and data, use the following syntax to specify your Lambda function.

      function= *lambda_arn*

      • The GLUE type takes a catalog ID parameter and is required. The *catalog_id* is the account ID of the AWS account to which the AWS Glue Data Catalog belongs.

      catalog-id= *catalog_id*

      • The GLUE data catalog type also applies to the default AwsDataCatalog that already exists in your account, of which you can have only one and cannot modify.
      • The FEDERATED data catalog type uses one of the following parameters, but not both. Use connection-arn for an existing AWS Glue connection. Use connection-type and connection-properties to specify the configuration setting for a new connection.
      • connection-arn: *<glue_connection_arn_to_reuse>*
      • lambda-role-arn (optional): The execution role to use for the Lambda function. If not provided, one is created.
      • connection-type:MYSQL|REDSHIFT|...., connection-properties:" *<json_string>* "

      For <json_string> , use escaped JSON text, as in the following example.

      "{\"spill_bucket\":\"my_spill\",\"spill_prefix\":\"athena-spill\",\"host\":\"abc12345.snowflakecomputing.com\",\"port\":\"1234\",\"warehouse\":\"DEV_WH\",\"database\":\"TEST\",\"schema\":\"PUBLIC\",\"SecretArn\":\"arn:aws:secretsmanager:ap-south-1:111122223333:secret:snowflake-XHb67j\"}"

      Returns:
      this

    • parameters

      @Stability(Stable) public CfnDataCatalogProps.Builder parameters(IResolvable parameters)
      Sets the value of CfnDataCatalogProps.getParameters()
      Parameters:
      parameters - Specifies the Lambda function or functions to use for creating the data catalog. This is a mapping whose values depend on the catalog type.

      • For the HIVE data catalog type, use the following syntax. The metadata-function parameter is required. The sdk-version parameter is optional and defaults to the currently supported version.

      metadata-function= *lambda_arn* , sdk-version= *version_number*

      • For the LAMBDA data catalog type, use one of the following sets of required parameters, but not both.
      • If you have one Lambda function that processes metadata and another for reading the actual data, use the following syntax. Both parameters are required.

      metadata-function= *lambda_arn* , record-function= *lambda_arn*

      • If you have a composite Lambda function that processes both metadata and data, use the following syntax to specify your Lambda function.

      function= *lambda_arn*

      • The GLUE type takes a catalog ID parameter and is required. The *catalog_id* is the account ID of the AWS account to which the AWS Glue Data Catalog belongs.

      catalog-id= *catalog_id*

      • The GLUE data catalog type also applies to the default AwsDataCatalog that already exists in your account, of which you can have only one and cannot modify.
      • The FEDERATED data catalog type uses one of the following parameters, but not both. Use connection-arn for an existing AWS Glue connection. Use connection-type and connection-properties to specify the configuration setting for a new connection.
      • connection-arn: *<glue_connection_arn_to_reuse>*
      • lambda-role-arn (optional): The execution role to use for the Lambda function. If not provided, one is created.
      • connection-type:MYSQL|REDSHIFT|...., connection-properties:" *<json_string>* "

      For <json_string> , use escaped JSON text, as in the following example.

      "{\"spill_bucket\":\"my_spill\",\"spill_prefix\":\"athena-spill\",\"host\":\"abc12345.snowflakecomputing.com\",\"port\":\"1234\",\"warehouse\":\"DEV_WH\",\"database\":\"TEST\",\"schema\":\"PUBLIC\",\"SecretArn\":\"arn:aws:secretsmanager:ap-south-1:111122223333:secret:snowflake-XHb67j\"}"

      Returns:
      this

    • status

      @Stability(Stable) public CfnDataCatalogProps.Builder status(String status)
      Sets the value of CfnDataCatalogProps.getStatus()
      Parameters:
      status - The status of the creation or deletion of the data catalog.
      • The LAMBDA , GLUE , and HIVE data catalog types are created synchronously. Their status is either CREATE_COMPLETE or CREATE_FAILED .
      • The FEDERATED data catalog type is created asynchronously.

      Data catalog creation status:

      • CREATE_IN_PROGRESS : Federated data catalog creation in progress.
      • CREATE_COMPLETE : Data catalog creation complete.
      • CREATE_FAILED : Data catalog could not be created.
      • CREATE_FAILED_CLEANUP_IN_PROGRESS : Federated data catalog creation failed and is being removed.
      • CREATE_FAILED_CLEANUP_COMPLETE : Federated data catalog creation failed and was removed.
      • CREATE_FAILED_CLEANUP_FAILED : Federated data catalog creation failed but could not be removed.

      Data catalog deletion status:

      • DELETE_IN_PROGRESS : Federated data catalog deletion in progress.
      • DELETE_COMPLETE : Federated data catalog deleted.
      • DELETE_FAILED : Federated data catalog could not be deleted.
      Returns:
      this

    • tags

      @Stability(Stable) public CfnDataCatalogProps.Builder tags(List<? extends CfnTag> tags)
      Sets the value of CfnDataCatalogProps.getTags()
      Parameters:
      tags - The tags (key-value pairs) to associate with this resource.
      Returns:
      this

    • build

      @Stability(Stable) public CfnDataCatalogProps build()
      Builds the configured instance.
      Specified by:
      build in interface software.amazon.jsii.Builder<CfnDataCatalogProps>
      Returns:
      a new instance of CfnDataCatalogProps
      Throws:
      NullPointerException - if any required attribute was not provided