aws-cdk-lib.aws_glue.CfnConnection.ConnectionInputProperty

interface ConnectionInputProperty

LanguageType name
.NETAmazon.CDK.AWS.Glue.CfnConnection.ConnectionInputProperty
Gogithub.com/aws/aws-cdk-go/awscdk/v2/awsglue#CfnConnection_ConnectionInputProperty
Javasoftware.amazon.awscdk.services.glue.CfnConnection.ConnectionInputProperty
Pythonaws_cdk.aws_glue.CfnConnection.ConnectionInputProperty
TypeScript aws-cdk-lib » aws_glue » CfnConnection » ConnectionInputProperty

A structure that is used to specify a connection to create or update.

Example

// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import { aws_glue as glue } from 'aws-cdk-lib';

declare const connectionProperties: any;
const connectionInputProperty: glue.CfnConnection.ConnectionInputProperty = {
  connectionType: 'connectionType',

  // the properties below are optional
  connectionProperties: connectionProperties,
  description: 'description',
  matchCriteria: ['matchCriteria'],
  name: 'name',
  physicalConnectionRequirements: {
    availabilityZone: 'availabilityZone',
    securityGroupIdList: ['securityGroupIdList'],
    subnetId: 'subnetId',
  },
};

Properties

NameTypeDescription
connectionTypestringThe type of the connection. Currently, these types are supported:.
connectionProperties?anyThese key-value pairs define parameters for the connection.
description?stringThe description of the connection.
matchCriteria?string[]A list of criteria that can be used in selecting this connection.
name?stringThe name of the connection.
physicalConnectionRequirements?IResolvable | PhysicalConnectionRequirementsPropertyA map of physical connection requirements, such as virtual private cloud (VPC) and SecurityGroup , that are needed to successfully make this connection.

connectionType

Type: string

The type of the connection. Currently, these types are supported:.

  • JDBC - Designates a connection to a database through Java Database Connectivity (JDBC).

JDBC Connections use the following ConnectionParameters.

  • Required: All of ( HOST , PORT , JDBC_ENGINE ) or JDBC_CONNECTION_URL .
  • Required: All of ( USERNAME , PASSWORD ) or SECRET_ID .
  • Optional: JDBC_ENFORCE_SSL , CUSTOM_JDBC_CERT , CUSTOM_JDBC_CERT_STRING , SKIP_CUSTOM_JDBC_CERT_VALIDATION . These parameters are used to configure SSL with JDBC.
  • KAFKA - Designates a connection to an Apache Kafka streaming platform.

KAFKA Connections use the following ConnectionParameters.

  • Required: KAFKA_BOOTSTRAP_SERVERS .
  • Optional: KAFKA_SSL_ENABLED , KAFKA_CUSTOM_CERT , KAFKA_SKIP_CUSTOM_CERT_VALIDATION . These parameters are used to configure SSL with KAFKA .
  • Optional: KAFKA_CLIENT_KEYSTORE , KAFKA_CLIENT_KEYSTORE_PASSWORD , KAFKA_CLIENT_KEY_PASSWORD , ENCRYPTED_KAFKA_CLIENT_KEYSTORE_PASSWORD , ENCRYPTED_KAFKA_CLIENT_KEY_PASSWORD . These parameters are used to configure TLS client configuration with SSL in KAFKA .
  • Optional: KAFKA_SASL_MECHANISM . Can be specified as SCRAM-SHA-512 , GSSAPI , or AWS_MSK_IAM .
  • Optional: KAFKA_SASL_SCRAM_USERNAME , KAFKA_SASL_SCRAM_PASSWORD , ENCRYPTED_KAFKA_SASL_SCRAM_PASSWORD . These parameters are used to configure SASL/SCRAM-SHA-512 authentication with KAFKA .
  • Optional: KAFKA_SASL_GSSAPI_KEYTAB , KAFKA_SASL_GSSAPI_KRB5_CONF , KAFKA_SASL_GSSAPI_SERVICE , KAFKA_SASL_GSSAPI_PRINCIPAL . These parameters are used to configure SASL/GSSAPI authentication with KAFKA .
  • MONGODB - Designates a connection to a MongoDB document database.

MONGODB Connections use the following ConnectionParameters.

  • Required: CONNECTION_URL .
  • Required: All of ( USERNAME , PASSWORD ) or SECRET_ID .
  • NETWORK - Designates a network connection to a data source within an Amazon Virtual Private Cloud environment (Amazon VPC).

NETWORK Connections do not require ConnectionParameters. Instead, provide a PhysicalConnectionRequirements.

  • MARKETPLACE - Uses configuration settings contained in a connector purchased from AWS Marketplace to read from and write to data stores that are not natively supported by AWS Glue .

MARKETPLACE Connections use the following ConnectionParameters.

  • Required: CONNECTOR_TYPE , CONNECTOR_URL , CONNECTOR_CLASS_NAME , CONNECTION_URL .
  • Required for JDBC CONNECTOR_TYPE connections: All of ( USERNAME , PASSWORD ) or SECRET_ID .
  • CUSTOM - Uses configuration settings contained in a custom connector to read from and write to data stores that are not natively supported by AWS Glue .

SFTP is not supported.

For more information about how optional ConnectionProperties are used to configure features in AWS Glue , consult AWS Glue connection properties .

For more information about how optional ConnectionProperties are used to configure features in AWS Glue Studio, consult Using connectors and connections .


connectionProperties?

Type: any (optional)

These key-value pairs define parameters for the connection.


description?

Type: string (optional)

The description of the connection.


matchCriteria?

Type: string[] (optional)

A list of criteria that can be used in selecting this connection.


name?

Type: string (optional)

The name of the connection.

Connection will not function as expected without a name.


physicalConnectionRequirements?

Type: IResolvable | PhysicalConnectionRequirementsProperty (optional)

A map of physical connection requirements, such as virtual private cloud (VPC) and SecurityGroup , that are needed to successfully make this connection.