연결 API - AWS Glue
 -  데이터 유형  -연결ConnectionInputPhysicalConnectionRequirementsGetConnectionsFilter -  작업  -CreateConnection (연결_생성)DeleteConnection (연결 삭제_)GetConnection (겟_커넥션)GetConnections (get_connection)UpdateConnection (업데이트_연결)BatchDeleteConnection (배치_삭제_연결)

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

연결 API

연결 API는 AWS Glue 연결 데이터 유형을 설명하고 연결을 생성, 삭제, 업데이트 및 나열하기 위한 API에 대해 설명합니다.

데이터 타입

연결 구조

데이터 원본으로 연결을 정의합니다.

필드

  • Name – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

    연결 정의 이름입니다.

  • Description – URI address multi-line string pattern과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다.

    연결에 대한 설명입니다.

  • ConnectionType – UTF-8 문자열입니다(유효한 값: JDBC | SFTP | MONGODB | KAFKA | NETWORK | MARKETPLACE | CUSTOM).

    연결 유형입니다. 현재 SFTP는 지원되지 않습니다.

  • MatchCriteria – 10개 이하의 문자열로 구성된 UTF-8 문자열입니다.

    이 연결을 선택할 때 사용할 수 있는 기준입니다.

  • ConnectionProperties – 100개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다.

    각 키는 UTF-8 문자열입니다 (유효한 값: HOST | | PORT | USERNAME="USER_NAME" | PASSWORD | ENCRYPTED_PASSWORD | JDBC_DRIVER_JAR_URI | JDBC_DRIVER_CLASS_NAME | JDBC_ENGINE | JDBC_ENGINE_VERSION | CONFIG_FILES | INSTANCE_ID | JDBC_CONNECTION_URL | JDBC_ENFORCE_SSL | CUSTOM_JDBC_CERT | SKIP_CUSTOM_JDBC_CERT_VALIDATION | CUSTOM_JDBC_CERT_STRING | CONNECTION_URL | KAFKA_BOOTSTRAP_SERVERS | KAFKA_SSL_ENABLED | KAFKA_CUSTOM_CERT | KAFKA_SKIP_CUSTOM_CERT_VALIDATION | KAFKA_CLIENT_KEYSTORE | KAFKA_CLIENT_KEYSTORE_PASSWORD | KAFKA_CLIENT_KEY_PASSWORD | | ENCRYPTED_KAFKA_CLIENT_KEYSTORE_PASSWORD | ENCRYPTED_KAFKA_CLIENT_KEY_PASSWORD | SECRET_ID | CONNECTOR_URL | CONNECTOR_TYPE | CONNECTOR_CLASS_NAME | KAFKA_SASL_MECHANISM | KAFKA_SASL_PLAIN_USERNAME | KAFKA_SASL_PLAIN_PASSWORD | ENCRYPTED_KAFKA_SASL_PLAIN_PASSWORD | KAFKA_SASL_SCRAM_USERNAME | KAFKA_SASL_SCRAM_PASSWORD| KAFKA_SASL_SCRAM_SECRETS_ARN | ENCRYPTED_KAFKA_SASL_SCRAM_PASSWORD | KAFKA_SASL_GSSAPI_KEYTAB KAFKA_SASL_GSSAPI_KRB5_CONF | KAFKA_SASL_GSSAPI_SERVICE |KAFKA_SASL_GSSAPI_PRINCIPAL).

    각 값은 1,024 바이트 이하 길이의 값 문자열입니다.

    이러한 키-값 쌍은 연결용 파라미터를 정의합니다.

    • HOST - 호스트 URI: 데이터베이스 호스트의 IPv4 주소 또는 FQDN(fully qualified domain name: 정규화된 도메인 이름).

    • PORT - 데이터베이스 호스트가 데이터베이스 연결을 수신 중인 포트의 포트 번호(1,024~65,535)입니다.

    • USER_NAME- 데이터베이스에 로그인할 이름. USER_NAME의 값 문자열은 "USERNAME"입니다.

    • PASSWORD- 사용자 이름에 해당하는 암호(사용할 경우).

    • ENCRYPTED_PASSWORD - 데이터 카탈로그 암호화 설정에서 ConnectionPasswordEncryption을 설정하여 연결 암호 보호를 활성화하면 이 필드가 암호화된 암호를 저장합니다.

    • JDBC_DRIVER_JAR_URI - 사용할 JDBC 드라이버가 포함된 JAR 파일의 Amazon Simple Storage Service(Amazon S3) 경로.

    • JDBC_DRIVER_CLASS_NAME- 사용할 JDBC 드라이버의 클래스 이름.

    • JDBC_ENGINE- 사용할 JDBC 엔진의 이름.

    • JDBC_ENGINE_VERSION - 사용할 JDBC 엔진의 버전.

    • CONFIG_FILES - (추후 사용 예약.)

    • INSTANCE_ID- 사용할 인스턴스 ID.

    • JDBC_CONNECTION_URL - JDBC 데이터 원본에 연결하기 위한 URL입니다.

    • JDBC_ENFORCE_SSL - 호스트 이름이 일치하는 Secure Sockets Layer(SSL)를 클라이언트의 JDBC 연결용으로 적용할지 여부를 지정하는 부울 문자열(true, false) 기본값은 false입니다.

    • CUSTOM_JDBC_CERT- 고객의 루트 인증서를 지정하는 Amazon S3 위치. AWS Glue 고객 데이터베이스에 연결할 때 이 루트 인증서를 사용하여 고객 인증서를 검증합니다. AWS Glue X.509 인증서만 처리합니다. 인증서는 DER로 인코딩되어 Base64 인코딩 PEM 형식으로 제공되어야 합니다.

    • SKIP_CUSTOM_JDBC_CERT_VALIDATION- 기본적으로 이것은 입니다. false AWS Glue 고객 인증서의 서명 알고리즘과 주제 공개 키 알고리즘을 검증합니다. 서명 알고리즘에 허용되는 유일한 알고리즘은 SHA256withRSA, SHA384withRSA 또는 SHA512withRSA. 주제 퍼블릭 키 알고리즘의 경우, 키 길이는 2048 이상이어야 합니다. 이 속성 값을 true로 설정하여 AWS Glue의 고객 인증서 검증을 건너뛸 수 있습니다.

    • CUSTOM_JDBC_CERT_STRING- 공격을 방지하기 위해 도메인 일치 또는 고유 이름 일치에 사용되는 사용자 지정 JDBC 인증서 문자열입니다. man-in-the-middle Oracle Database에서는 SSL_SERVER_CERT_DN으로, Microsoft SQL Server에서는 hostNameInCertificate로 사용됩니다.

    • CONNECTION_URL - 일반(비JDBC) 데이터 원본에 연결하기 위한 URL입니다.

    • SECRET_ID - 자격 증명의 보안 관리자에 사용되는 보안 암호 ID입니다.

    • CONNECTOR_URL - MARKETPLACE 또는 CUSTOM 연결을 위한 커넥터 URL입니다.

    • CONNECTOR_TYPE - MARKETPLACE 또는 CUSTOM 연결을 위한 커넥터 유형입니다.

    • CONNECTOR_CLASS_NAME - MARKETPLACE 또는 CUSTOM 연결을 위한 커넥터 클래스 이름입니다.

    • KAFKA_BOOTSTRAP_SERVERS - Kafka 클라이언트에서 연결하고 자체 부트스트랩하는 Kafka 클러스터에 있는 Apache Kafka 브로커의 주소입니다 호스트 및 포트 쌍의 쉼표로 구분된 목록입니다.

    • KAFKA_SSL_ENABLED - Apache Kafka 연결에서 SSL을 사용할지 아니면 사용 중지할지 여부입니다. 기본값은 "true"입니다.

    • KAFKA_CUSTOM_CERT - 프라이빗 CA 인증서 파일(.pem 포맷)의 Amazon S3 URL입니다. 기본값은 빈 문자열입니다.

    • KAFKA_SKIP_CUSTOM_CERT_VALIDATION- CA 인증서 파일의 유효성 검사를 건너뛰는지 여부. AWS Glue RSA를 사용하는 SHA256, RSA를 사용하는 SHA384, RSA를 사용하는 SHA512의 세 가지 알고리즘을 검증합니다. 기본값은 "false"입니다.

    • KAFKA_CLIENT_KEYSTORE - Kafka 클라이언트 측 인증을 위한 클라이언트 키 스토어 파일의 Amazon S3 위치입니다(선택 사항).

    • KAFKA_CLIENT_KEYSTORE_PASSWORD - 제공된 키 스토어에 액세스하기 위한 암호입니다(선택 사항).

    • KAFKA_CLIENT_KEY_PASSWORD - 키 스토어는 여러 키로 구성 될 수 있으므로 Kafka 서버 측 키와 함께 사용할 클라이언트 키에 액세스하기 위한 암호입니다(선택 사항).

    • ENCRYPTED_KAFKA_CLIENT_KEYSTORE_PASSWORD- Kafka 클라이언트 키스토어 비밀번호의 암호화된 버전 (사용자가 비밀번호 암호화 설정을 선택한 경우) AWS Glue

    • ENCRYPTED_KAFKA_CLIENT_KEY_PASSWORD- 암호화된 버전의 Kafka 클라이언트 키 암호 (사용자가 암호 암호화 설정을 선택한 경우) AWS Glue

    • KAFKA_SASL_MECHANISM-"SCRAM-SHA-512","GSSAPI", "AWS_MSK_IAM" 또는. "PLAIN" 다음은 지원되는 SASL 메커니즘입니다.

    • KAFKA_SASL_PLAIN_USERNAME- “PLAIN” 메커니즘으로 인증하는 데 사용되는 일반 텍스트 사용자 이름.

    • KAFKA_SASL_PLAIN_PASSWORD- “PLAIN” 메커니즘으로 인증하는 데 사용되는 일반 텍스트 비밀번호입니다.

    • ENCRYPTED_KAFKA_SASL_PLAIN_PASSWORD- Kafka SASL PLAIN 암호의 암호화된 버전 (사용자가 암호 암호화 설정을 선택한 경우) AWS Glue

    • KAFKA_SASL_SCRAM_USERNAME - "SCRAM-SHA-512" 메커니즘으로 인증하는 데 사용되는 일반 텍스트 사용자 이름입니다.

    • KAFKA_SASL_SCRAM_PASSWORD - "SCRAM-SHA-512" 메커니즘으로 인증하는 데 사용되는 일반 텍스트 암호입니다.

    • ENCRYPTED_KAFKA_SASL_SCRAM_PASSWORD- Kafka SASL SCRAM 암호의 암호화된 버전 (사용자가 암호 암호화 설정을 선택한 경우) AWS Glue

    • KAFKA_SASL_SCRAM_SECRETS_ARN- AWS Secrets Manager에 있는 시크릿의 아마존 리소스 이름

    • KAFKA_SASL_GSSAPI_KEYTAB - Kerberos keytab 파일의 S3 위치입니다. keytab은 하나 이상의 보안 주체에 대한 장기 키를 저장합니다. 자세한 내용은 MIT Kerberos Documentation: Keytab(MIT Kerberos 설명서: Keytab)을 참조하세요.

    • KAFKA_SASL_GSSAPI_KRB5_CONF - Kerberos krb5.conf 파일의 S3 위치입니다. krb5.conf는 KDC 서버의 위치와 같은 Kerberos 구성 정보를 저장합니다. 자세한 내용은 MIT Kerberos Documentation: krb5.conf(MIT Kerberos 설명서: krb5.conf)를 참조하세요.

    • KAFKA_SASL_GSSAPI_SERVICE - Kafka 구성에서 sasl.kerberos.service.name으로 설정된 Kerberos 서비스 이름입니다.

    • KAFKA_SASL_GSSAPI_PRINCIPAL- 에서 사용하는 케르베로스 교장의 이름. AWS Glue 자세한 내용은 Kafka Documentation: Configuring Kafka Brokers(Kafka 설명서: Kafka 브로커 구성)를 참조하세요.

  • PhysicalConnectionRequirements – PhysicalConnectionRequirements 객체입니다.

    Virtual Private Cloud(VPC) 및 SecurityGroup과 같이 이 연결을 설정하는 데 필요한 물리적 연결 요구 사항의 맵입니다.

  • CreationTime – 타임스탬프입니다.

    이 연결 정의가 생성된 시간입니다.

  • LastUpdatedTime – 타임스탬프입니다.

    이 연결 정의가 업데이트된 마지막 시간입니다.

  • LastUpdatedBy – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

    이 연결 정의를 마지막으로 업데이트한 사용자, 그룹 혹은 역할입니다.

ConnectionInput 구조

생성 혹은 업데이트를 위한 연결을 지정할 때 사용되는 구조입니다.

필드

  • Name – 필수: Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

    연결의 이름입니다. 이름이 없으면 연결이 예상대로 작동하지 않습니다.

  • Description – URI address multi-line string pattern과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다.

    연결에 대한 설명입니다.

  • ConnectionType – 필수: UTF-8 문자열입니다(유효한 값: JDBC | SFTP | MONGODB | KAFKA | NETWORK | MARKETPLACE | CUSTOM).

    연결 유형입니다. 현재 이러한 유형이 지원됩니다.

    • JDBC - JDBC(Java Database Connectivity)를 통해 데이터베이스에 대한 연결을 지정합니다.

      JDBC연결은 다음을 사용합니다 ConnectionParameters.

      • 필수 항목: JDBC_CONNECTION_URL 또는 (HOST, PORT, JDBC_ENGINE) 모두.

      • 필수 항목: SECRET_ID 또는 (USERNAME, PASSWORD) 모두.

      • 선택 사항: JDBC_ENFORCE_SSL, CUSTOM_JDBC_CERT, CUSTOM_JDBC_CERT_STRING, SKIP_CUSTOM_JDBC_CERT_VALIDATION. 이러한 파라미터는 JDBC로 SSL을 구성하는 데 사용됩니다.

    • KAFKA - Apache Kafka 스트리밍 플랫폼에 대한 연결을 지정합니다.

      KAFKA연결은 다음을 사용합니다 ConnectionParameters.

      • 필수 항목: KAFKA_BOOTSTRAP_SERVERS.

      • 선택 사항: KAFKA_SSL_ENABLED, KAFKA_CUSTOM_CERT, KAFKA_SKIP_CUSTOM_CERT_VALIDATION. 이러한 파라미터는 KAFKA로 SSL을 구성하는 데 사용됩니다.

      • 선택 사항: KAFKA_CLIENT_KEYSTORE, KAFKA_CLIENT_KEYSTORE_PASSWORD, KAFKA_CLIENT_KEY_PASSWORD, ENCRYPTED_KAFKA_CLIENT_KEYSTORE_PASSWORD, ENCRYPTED_KAFKA_CLIENT_KEY_PASSWORD. 이러한 파라미터는 KAFKA에서 SSL로 TLS 클라이언트 구성을 지정하는 데 사용됩니다.

      • 선택 사항: KAFKA_SASL_MECHANISM SCRAM-SHA-512, GSSAPI 또는 AWS_MSK_IAM으로 지정할 수 있습니다.

      • 선택 사항: KAFKA_SASL_SCRAM_USERNAME, KAFKA_SASL_SCRAM_PASSWORD, ENCRYPTED_KAFKA_SASL_SCRAM_PASSWORD. 이러한 파라미터는 KAFKA로 SASL/SCRAM-SHA-512 인증을 구성하는 데 사용됩니다.

      • 선택 사항: KAFKA_SASL_GSSAPI_KEYTAB, KAFKA_SASL_GSSAPI_KRB5_CONF, KAFKA_SASL_GSSAPI_SERVICE, KAFKA_SASL_GSSAPI_PRINCIPAL. 이러한 파라미터는 KAFKA로 SASL/GSSAPI 인증을 구성하는 데 사용됩니다.

    • MONGODB - MongoDB 문서 데이터베이스에 대한 연결을 지정합니다.

      MONGODB연결은 다음을 사용합니다 ConnectionParameters.

      • 필수 항목: CONNECTION_URL.

      • 필수 항목: SECRET_ID 또는 (USERNAME, PASSWORD) 모두.

    • NETWORK - Amazon Virtual Private Cloud(Amazon VPC) 환경 내의 데이터 원본에 대한 네트워크 연결을 지정합니다.

      NETWORK연결은 필요하지 않습니다 ConnectionParameters. 대신 a를 PhysicalConnectionRequirements 제공하세요.

    • MARKETPLACE- 구입한 커넥터에 포함된 구성 설정을 사용하여 에서 기본적으로 AWS Glue 지원되지 않는 데이터 저장소에서 읽고 쓸 수 있습니다. AWS Marketplace

      MARKETPLACE연결에는 다음이 사용됩니다. ConnectionParameters

      • 필수 항목: CONNECTOR_TYPE, CONNECTOR_URL, CONNECTOR_CLASS_NAME, CONNECTION_URL.

      • JDBC CONNECTOR_TYPE 연결에 필요: SECRET_ID 또는 (USERNAME, PASSWORD) 모두.

    • CUSTOM - AWS Glue에서 기본적으로 지원하지 않는 데이터 스토어에서 읽고 쓰기 위해 사용자 정의 커넥터에 포함된 구성 설정을 사용합니다.

    SFTP는 지원되지 않습니다.

    옵션을 ConnectionProperties 사용하여 기능을 구성하는 방법에 대한 자세한 내용은 AWS Glue 연결 속성을 참조하십시오. AWS Glue

    AWS Glue Studio에서 옵션을 ConnectionProperties 사용하여 기능을 구성하는 방법에 대한 자세한 내용은 커넥터 및 연결 사용을 참조하십시오.

  • MatchCriteria – 10개 이하의 문자열로 구성된 UTF-8 문자열입니다.

    이 연결을 선택할 때 사용할 수 있는 기준입니다.

  • ConnectionProperties – 필수(Required): 100개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다.

    각 키는 UTF-8 문자열입니다 (유효한 값: HOST | PORT | USERNAME="USER_NAME" | PASSWORD | ENCRYPTED_PASSWORD | JDBC_DRIVER_JAR_URI | JDBC_DRIVER_CLASS_NAME | JDBC_ENGINE | JDBC_ENGINE_VERSION | CONFIG_FILES | INSTANCE_ID | JDBC_CONNECTION_URL | JDBC_ENFORCE_SSL | | CUSTOM_JDBC_CERT | SKIP_CUSTOM_JDBC_CERT_VALIDATION | CUSTOM_JDBC_CERT_STRING | CONNECTION_URL | KAFKA_BOOTSTRAP_SERVERS | KAFKA_SSL_ENABLED | KAFKA_CUSTOM_CERT | KAFKA_SKIP_CUSTOM_CERT_VALIDATION | KAFKA_CLIENT_KEYSTORE | KAFKA_CLIENT_KEYSTORE_PASSWORD | KAFKA_CLIENT_KEY_PASSWORD | ENCRYPTED_KAFKA_CLIENT_KEYSTORE_PASSWORD | ENCRYPTED_KAFKA_CLIENT_KEY_PASSWORD | SECRET_ID | CONNECTOR_URL | CONNECTOR_TYPE | CONNECTOR_CLASS_NAME | KAFKA_SASL_MECHANISM | KAFKA_SASL_PLAIN_USERNAME | KAFKA_SASL_PLAIN_PASSWORD | ENCRYPTED_KAFKA_SASL_PLAIN_PASSWORD | KAFKA_SASL_SCRAM_USERNAME | KAFKA_SASL_SCRAM_PASSWORD| KAFKA_SASL_SCRAM_SECRETS_ARN | ENCRYPTED_KAFKA_SASL_SCRAM_PASSWORD | KAFKA_SASL_GSSAPI_KEYTAB KAFKA_SASL_GSSAPI_KRB5_CONF | KAFKA_SASL_GSSAPI_SERVICE |KAFKA_SASL_GSSAPI_PRINCIPAL).

    각 값은 1,024 바이트 이하 길이의 값 문자열입니다.

    이러한 키-값 쌍은 연결용 파라미터를 정의합니다.

  • PhysicalConnectionRequirements – PhysicalConnectionRequirements 객체입니다.

    Virtual Private Cloud(VPC) 및 SecurityGroup과 같이 이 연결을 설정하는 데 필요한 물리적 연결 요구 사항의 맵입니다.

PhysicalConnectionRequirements 구조

연결을 위한 물리적 요구 사항을 지정합니다.

필드

  • SubnetId – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

    연결에서 사용하는 서브넷 ID입니다.

  • SecurityGroupIdList – 50개 이하의 문자열로 구성된 UTF-8 문자열입니다.

    연결에서 사용하는 보안 그룹 ID 목록입니다.

  • AvailabilityZone – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

    연결의 가용 영역입니다. 이 필드는 지정된 서브넷에서 사용할 가용 영역을 암시하므로 중복됩니다. 현재는 이 필드가 채워져야 하지만 향후에는 사용되지 않습니다.

GetConnectionsFilter 구조

GetConnections API 작업에서 반환하는 연결 정의를 필터링합니다.

필드

  • MatchCriteria – 10개 이하의 문자열로 구성된 UTF-8 문자열입니다.

    연결 정의가 반환되도록 연결 정의에 기록된 기준과 반드시 일치해야 하는 기준 문자열입니다.

  • ConnectionType – UTF-8 문자열입니다(유효한 값: JDBC | SFTP | MONGODB | KAFKA | NETWORK | MARKETPLACE | CUSTOM).

    반환할 연결 유형입니다. 현재 SFTP는 지원되지 않습니다.

운영

CreateConnection 액션 (Python: 커넥션 생성하기)

데이터 카탈로그에서 연결 정의를 생성합니다.

페더레이션 리소스를 생성하는 데 사용되는 연결에는 IAM glue:PassConnection 권한이 필요합니다.

요청

  • CatalogId – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 카탈로그 ID 문자열입니다.

    연결을 생성할 데이터 카탈로그의 ID입니다. 아무 것도 제공하지 않으면 기본적으로 AWS 계정 ID가 사용됩니다.

  • ConnectionInput – 필수(Required): ConnectionInput 객체입니다.

    생성할 연결을 정의하는 ConnectionInput 객체입니다.

  • Tags – 50개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다.

    각 키는 길이가 1~128바이트인 UTF-8 문자열입니다.

    각 값은 256 바이트 이하 길이의 UTF-8 문자열입니다.

    연결에 할당하는 태그입니다.

응답

  • 무응답 파라미터.

Errors

  • AlreadyExistsException

  • InvalidInputException

  • OperationTimeoutException

  • ResourceNumberLimitExceededException

  • GlueEncryptionException

DeleteConnection 액션 (Python: 연결 삭제_)

데이터 카탈로그에서 연결을 삭제합니다.

요청

  • CatalogId – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 카탈로그 ID 문자열입니다.

    연결이 지속될 데이터 카탈로그의 ID입니다. 아무 것도 제공하지 않으면 기본적으로 AWS 계정 ID가 사용됩니다.

  • ConnectionName – 필수(Required): Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

    삭제할 연결의 이름입니다.

응답

  • 무응답 파라미터.

Errors

  • EntityNotFoundException

  • OperationTimeoutException

GetConnection 액션 (파이썬: 겟_커넥션)

데이터 카탈로그에서 연결 정의를 검색합니다.

요청

  • CatalogId – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 카탈로그 ID 문자열입니다.

    연결이 지속될 데이터 카탈로그의 ID입니다. 아무 것도 제공하지 않으면 기본적으로 AWS 계정 ID가 사용됩니다.

  • Name – 필수(Required): Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

    검색할 연결 정의 이름입니다.

  • HidePassword – 부울입니다.

    암호를 반환하지 않고 연결 메타데이터를 검색할 수 있습니다. 예를 들어 AWS Glue 콘솔은 이 플래그를 사용하여 연결을 검색하고 비밀번호는 표시하지 않습니다. 발신자가 AWS KMS 키를 사용하여 암호를 해독할 권한은 없지만 나머지 연결 속성에 액세스할 수 있는 권한은 있는 경우 이 매개 변수를 설정합니다.

응답

  • Connection – 연결 객체입니다.

    요청한 연결 정의입니다.

Errors

  • EntityNotFoundException

  • OperationTimeoutException

  • InvalidInputException

  • GlueEncryptionException

GetConnections 액션 (파이썬: get_connections)

데이터 카탈로그에서 연결 정의의 목록을 검색합니다.

요청

  • CatalogId – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 카탈로그 ID 문자열입니다.

    연결이 지속될 데이터 카탈로그의 ID입니다. 아무 것도 제공하지 않으면 기본적으로 AWS 계정 ID가 사용됩니다.

  • Filter – GetConnectionsFilter 객체입니다.

    반환되는 연결을 관리하는 필터입니다.

  • HidePassword – 부울입니다.

    암호를 반환하지 않고 연결 메타데이터를 검색할 수 있습니다. 예를 들어 AWS Glue 콘솔은 이 플래그를 사용하여 연결을 검색하고 비밀번호는 표시하지 않습니다. 발신자가 AWS KMS 키를 사용하여 암호를 해독할 권한은 없지만 나머지 연결 속성에 액세스할 수 있는 권한은 있는 경우 이 매개 변수를 설정합니다.

  • NextToken – UTF-8 문자열입니다.

    이것이 지속적으로 호출되면 지속적인 토큰입니다.

  • MaxResults – 1~1,000의 숫자(정수)입니다.

    한 번의 응답으로 반환될 최대 결과 수입니다.

응답

  • ConnectionList – 연결 객체의 배열입니다.

    요청한 연결 정의의 목록입니다.

  • NextToken – UTF-8 문자열입니다.

    반환된 연결 목록이 필터링된 연결의 마지막을 포함하지 않는 경우의 연속 토큰입니다.

Errors

  • EntityNotFoundException

  • OperationTimeoutException

  • InvalidInputException

  • GlueEncryptionException

UpdateConnection 액션 (Python: 업데이트_연결)

데이터 카탈로그에서 연결 정의를 업데이트합니다.

요청

  • CatalogId – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 카탈로그 ID 문자열입니다.

    연결이 지속될 데이터 카탈로그의 ID입니다. 아무 것도 제공하지 않으면 기본적으로 AWS 계정 ID가 사용됩니다.

  • Name – 필수(Required): Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

    업데이트할 연결 정의 이름입니다.

  • ConnectionInput – 필수(Required): ConnectionInput 객체입니다.

    질의에 따른 연결을 재정의하는 ConnectionInput 객체입니다.

응답

  • 무응답 파라미터.

Errors

  • InvalidInputException

  • EntityNotFoundException

  • OperationTimeoutException

  • InvalidInputException

  • GlueEncryptionException

BatchDeleteConnection 액션 (Python: 배치_삭제_연결)

데이터 카탈로그에서 연결 정의의 목록을 삭제합니다.

요청

  • CatalogId – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 카탈로그 ID 문자열입니다.

    연결이 지속될 데이터 카탈로그의 ID입니다. 아무 것도 제공하지 않으면 기본적으로 AWS 계정 ID가 사용됩니다.

  • ConnectionNameList – 필수(Required): 25개 이하의 문자열로 구성된 UTF-8 문자열입니다.

    삭제할 연결 이름의 목록입니다.

응답

  • Succeeded – UTF-8 문자열의 배열입니다.

    성공적으로 삭제된 연결 정의 이름의 목록입니다.

  • Errors – 키-값 페어의 맵 배열입니다.

    각 키는 Single-line string pattern과(와) 일치하는 1~255 바이트 길이의 UTF-8 문자열입니다.

    각 값은 ErrorDetail 객체입니다.

    오류 세부 정보에서 성공적으로 삭제된 연결 이름의 맵입니다.

Errors

  • InternalServiceException

  • OperationTimeoutException