Amazon Redshift는 패치 198부터 새 Python UDF 생성을 더 이상 지원하지 않습니다. 기존 Python UDF는 2026년 6월 30일까지 계속 작동합니다. 자세한 내용은 [블로그 게시물](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/)을 참조하세요.

# 제로 ETL 통합 보기
<a name="zero-etl-using.describing"></a>

Amazon Redshift 콘솔에서 제로 ETL 통합을 확인할 수 있습니다. 여기에서 구성 정보 및 현재 상태를 확인하고 화면을 열어 데이터를 쿼리하고 공유할 수 있습니다.

------
#### [ Amazon Redshift console ]

**제로 ETL 통합 세부 정보를 보려면**

1. AWS Management Console에 로그인한 후 [https://console.aws.amazon.com/redshiftv2/](https://console.aws.amazon.com/redshiftv2/)에서 Amazon Redshift 콘솔을 엽니다.

1. 왼쪽 탐색 창에서 **서버리스** 또는 **프로비저닝된 클러스터** 대시보드 중 하나를 선택합니다. 그런 다음 **제로 ETL 통합**을 선택합니다.

1. 보려는 제로 ETL 통합을 선택합니다. 각 통합에 대해 다음 필수 정보가 제공됩니다.
   + **통합 ID**는 통합이 생성될 때 반환되는 식별자입니다.
   + **상태**는 다음 값 중 하나일 수 있습니다.
     + `Active` - 제로 ETL 통합이 트랜잭션 데이터를 대상 Amazon Redshift 데이터 웨어하우스로 전송하고 있습니다.
     + `Syncing` - 제로 ETL 통합에 복구 가능한 오류가 발생하여 데이터를 다시 시드하고 있습니다. 영향을 받는 테이블은 재동기화가 완료될 때까지 Amazon Redshift에서 쿼리할 수 없습니다.
     + `Failed` - 제로 ETL 통합에서 복구할 수 없는 이벤트 또는 수정할 수 없는 오류가 발생했습니다. 제로 ETL 통합을 삭제하고 다시 만들어야 합니다.
     + `Creating` - 제로 ETL 통합이 생성 중입니다.
     + `Deleting` - 제로 ETL 통합이 삭제 중입니다.
     + `Needs attention` - 제로 ETL 통합에 수동 개입이 필요한 이벤트 또는 오류가 발생하여 이를 해결해야 합니다. 문제를 해결하려면 오류 메시지의 단계를 따르세요.
   + **소스 유형**은 대상에 복제되는 소스 데이터의 유형입니다. 유형은 다른 데이터베이스 관리자를 지정할 수 있습니다(예: Aurora MySQL-Compatible Edition, Amazon Aurora PostgreSQL, RDS for MySQL 및 애플리케이션에서(`GlueSAAS`)).
   + **소스 ARN**은 소스 데이터의 ARN입니다. 대부분의 소스의 경우 소스 데이터베이스 또는 테이블의 ARN입니다. 애플리케이션 소스와의 제로 ETL 통합의 경우 AWS Glue 연결 객체의 ARN입니다.
   + **대상**은 소스 데이터를 수신하는 Amazon Redshift 데이터 웨어하우스의 네임스페이스입니다.
   + **데이터베이스**는 다음 중 하나일 수 있습니다.
     + `No database` - 통합을 위한 대상 데이터베이스가 없습니다.
     + `Creating` - Amazon Redshift가 통합을 위한 대상 데이터베이스를 만들고 있습니다.
     + `Active` - 데이터가 통합 소스에서 Amazon Redshift로 복제되고 있습니다.
     + `Error` - 통합에 오류가 있습니다.
     + `Recovering` - 데이터 웨어하우스가 다시 시작된 후 통합이 복구 중입니다.
     + `Resyncing` - Amazon Redshift가 통합에서 테이블을 다시 동기화하는 중입니다.
   + **대상 유형**은 Amazon Redshift 데이터 웨어하우스의 유형입니다.
   + **생성 날짜**는 통합이 생성된 날짜 및 시간(UTC)입니다.

**참고**  
데이터 웨어하우스의 통합 세부 정보를 보려면 프로비저닝된 클러스터 또는 서버리스 네임스페이스의 세부 정보 페이지를 선택한 다음 **제로 ETL 통합** 탭을 선택합니다.

**제로 ETL 통합** 목록에서 **쿼리 데이터**를 선택하여 Amazon Redshift 쿼리 에디터 v2로 이동할 수 있습니다. Amazon Redshift 대상 데이터베이스에는 [enable\$1case\$1sensitive\$1identifier](https://docs.aws.amazon.com/redshift/latest/dg/r_enable_case_sensitive_identifier.html) 파라미터가 활성화되어 있습니다. SQL을 작성할 때 스키마, 테이블 및 열 이름을 큰따옴표("<이름>")로 묶어야 할 수 있습니다. Amazon Redshift 데이터 웨어하우스의 데이터를 쿼리하는 방법에 대한 자세한 내용은 [Query Editor V2를 사용하여 데이터베이스 쿼리Amazon Redshift 쿼리 편집기 v2를 사용하여 데이터베이스 쿼리](query-editor-v2.md) 섹션을 참조하세요.

**제로 ETL 통합** 목록에서 **데이터 공유**를 선택하여 데이터 공유를 생성할 수 있습니다. Amazon Redshift 데이터베이스에 데이터 공유를 생성하려면 **데이터 공유 생성** 페이지의 지침을 따르세요. Amazon Redshift 데이터베이스에서 데이터를 공유하려면 먼저 대상 데이터베이스를 만들어야 합니다. 데이터 공유에 대한 자세한 내용은 [Amazon Redshift의 데이터 공유 개념](https://docs.aws.amazon.com/redshift/latest/dg/concepts.html)을 참조하세요.

통합을 새로 고치려면 [ALTER DATABASE](https://docs.aws.amazon.com/redshift/latest/dg/r_ALTER_DATABASE.html) 명령을 사용할 수 있습니다. 이렇게 하면 통합 소스의 모든 데이터가 대상 데이터베이스로 복제됩니다. 다음 예시는 제로 ETL 통합 내에서 동기화된 테이블과 실패한 테이블을 모두 새로 고칩니다.

```
ALTER DATABASE sample_integration_db INTEGRATION REFRESH ALL tables;
```

------
#### [ AWS CLI ]

AWS CLI를 사용하여 Amazon Redshift와의 Amazon DynamoDB 제로 ETL 통합을 설명하려면 다음 옵션과 함께 `describe-integrations` 명령을 사용합니다.
+ `integration-arn` – 설명할 DynamoDB 통합의 ARN을 지정합니다.
+ `integration-name` - 반환할 하나 이상의 리소스를 지정하는 선택적 필터를 지정합니다.

다음 예제에서는 통합 ARN을 제공하여 통합을 설명합니다.

```
aws redshift describe-integrations
                 
{
    "Integrations": [
        {
            "Status": "failed", 
            "IntegrationArn": "arn:aws:redshift:us-east-1:123456789012:integration:a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", 
            "Errors": [
                {
                    "ErrorCode": "INVALID_TABLE_PERMISSIONS", 
                    "ErrorMessage": "Redshift does not have sufficient access on the table key. Refer to the Amazon DynamoDB Developer Guide."
                }
            ], 
            "Tags": [], 
            "CreateTime": "2023-11-09T00:32:46.444Z", 
            "KMSKeyId": "arn:aws:kms:us-east-1:123456789012:key/a1b2c3d4-5678-90ab-cdef-EXAMPLE33333", 
            "TargetArn": "arn:aws:redshift:us-east-1:123456789012:namespace:a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", 
            "IntegrationName": "ddb-to-provisioned-02", 
            "SourceArn": "arn:aws:dynamodb:us-east-1:123456789012:table/mytable"
        }
    ]
}
```

`integration-arn`, `source-arn`, `source-types`또는 를 `describe-integrations` 기준으로 결과를 필터링할 수도 있습니다`status`. 자세한 내용은 *Amazon Redshift CLI 설명서*의 [describe-integrations](https://docs.aws.amazon.com/cli/latest/reference/redshift/describe-integrations.html)를 참조하세요.

------