SYSTEM$GET_PRIVATELINK_ENDPOINTS_INFO¶

구문¶

SYSTEM$GET_PRIVATELINK_ENDPOINTS_INFO()

반환¶

다음 필드가 있는 JSON 오브젝트를 반환합니다.

AWS:

provider_service_name

서비스 또는 리소스 이름입니다.

snowflake_endpoint_name

Snowflake 계정의 VPC 엔드포인트 ID 입니다. 이 필드에는 엔드포인트가 생성되는 동안 임시 이름이 포함됩니다. 엔드포인트가 만들어지고 endpoint_state 가 CREATED 로 변경되면 이 이름이 변경됩니다.

endpoint_state

Snowflake의 엔드포인트 상태입니다. 이 필드에는 다음 상태 중 하나를 포함할 수 있습니다.

• PENDING_CREATION: 엔드포인트가 아직 생성 중입니다.

• CREATED: 클라우드 공급자로부터 엔드포인트가 성공적으로 생성되었으며 사용할 준비가 되었다는 응답을 받았음을 나타냅니다.

• FAILED: 엔드포인트가 클라우드 공급자의 예기치 않은 상태에 있어 사용할 수 없습니다.

• PENDING_DELETION: 엔드포인트가 삭제 큐에 있지만 복원할 수 있습니다.

• DELETING: 엔드포인트가 클라우드 공급업체에서 삭제되고 있으며 복원할 수 없습니다.

host

서비스에 연결하는 데 사용되는 호스트 이름입니다.

status

AWS 의 엔드포인트 프로비저닝 상태. 이 필드에는 다음 상태 중 하나가 포함될 수 있습니다.

• Pending: 엔드포인트가 아직 생성 중입니다.

• Available: 엔드포인트가 생성되어 사용할 준비가 되었습니다.

Azure:

provider_resource_id

엔드포인트가 연결되는 리소스의 Azure 리소스 ID.

subresource

엔드포인트가 연결되는 Azure 리소스의 하위 리소스입니다.

snowflake_resource_id

Azure 리소스에 연결되는 비공개 엔드포인트의 Azure 리소스 ID.

host

리소스에 연결하는 데 사용되는 호스트 이름입니다.

endpoint_state

Snowflake의 엔드포인트 상태입니다. 이 필드에는 다음 상태 중 하나를 포함할 수 있습니다.

• PENDING_CREATION: 엔드포인트가 아직 생성 중입니다.

• CREATED: 클라우드 공급자로부터 엔드포인트가 성공적으로 생성되었으며 사용할 준비가 되었다는 응답을 받았음을 나타냅니다.

• FAILED: 엔드포인트가 클라우드 공급자의 예기치 않은 상태에 있어 사용할 수 없습니다.

• PENDING_DELETION: 엔드포인트가 삭제 큐에 있지만 복원할 수 있습니다.

• DELETING: 엔드포인트가 클라우드 공급업체에서 삭제되고 있으며 복원할 수 없습니다.

status

Microsoft Azure 의 엔드포인트 프로비저닝 상태. 이 필드를 사용하여 Microsoft Azure 에서 리소스에 대한 비공개 엔드포인트 연결을 승인했는지 확인합니다. 이 필드에는 다음 상태 중 하나가 포함될 수 있습니다.

• APPROVED

• PENDING

• DISCONNECTED

• REJECTED

사용법 노트¶

• 이 함수는 비공개 연결을 검색하는 프로세스에 따라 실행하는 데 약 5분 정도 소요될 수 있습니다

• 클라우드 플랫폼의 엔드포인트(Snowflake 외부).

예¶

AWS:

Amazon S3에 대한 외부 액세스 권한이 있는 모든 PrivateLink 엔드포인트를 나열하고 다음 SQL 문을 실행합니다.

SELECT SYSTEM$GET_PRIVATELINK_ENDPOINTS_INFO();

[
  {
    "provider_service_name": "com.amazonaws.us-west-2.s3",
    "snowflake_endpoint_name": "vpce-123456789012abcdea",
    "endpoint_state": "CREATED",
    "host": "*.s3.us-west-2.amazonaws.com",
    "status": "Available"
  },
  ...
]

Azure:

Microsoft Azure의 Snowflake 계정에 대해 프로비저닝한 비공개 연결 엔드포인트와 각 엔드포인트가 연결된 서비스 이름을 나열합니다.

SQLReturned value

SELECT SYSTEM$GET_PRIVATELINK_ENDPOINTS_INFO();

Copy