가져오기 주제를 표준 주제로 변환하거나 그 반대로 표준 주제를 가져오기 주제로 변환할 수 있습니다.
가져오기 주제를 표준 주제로 변환
가져오기 주제를 표준 주제로 변환하려면 수집 설정을 삭제합니다. 다음 단계를 수행합니다.
콘솔
Trusted Cloud 콘솔에서 주제 페이지로 이동합니다.
가져오기 주제를 클릭합니다.
주제 세부정보 페이지에서 수정을 클릭합니다.
수집 사용 설정 옵션을 삭제합니다.
업데이트를 클릭합니다.
gcloud
In the Trusted Cloud console, activate Cloud Shell.
At the bottom of the Trusted Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
gcloud pubsub topics update
명령어를 실행합니다.gcloud pubsub topics update TOPIC_ID \ --clear-ingestion-data-source-settings
TOPIC_ID를 주제 ID로 바꿉니다.
표준 주제를 Amazon Kinesis Data Streams 가져오기 주제로 변환
표준 주제를 Amazon Kinesis Data Streams 가져오기 주제로 변환하려면 먼저 모든 기본 요건을 충족하는지 확인합니다.
콘솔
-
Trusted Cloud 콘솔에서 주제 페이지로 이동합니다.
-
가져오기 주제로 변환할 주제를 클릭합니다.
-
주제 세부정보 페이지에서 수정을 클릭합니다.
-
수집 사용 설정 옵션을 선택합니다.
-
수집 소스의 경우 Amazon Kinesis Data Streams를 선택합니다.
-
다음 세부정보를 입력합니다.
-
Kinesis 스트림 ARN: Pub/Sub로 수집하려는 Kinesis Data Stream의 ARN입니다. ARN 형식은
arn:${Partition}:kinesis:${Region}:${Account}:stream/${StreamName}
입니다. -
Kinesis 소비자 ARN: AWS Kinesis Data Stream에 등록된 소비자 리소스의 ARN입니다. ARN 형식은
arn:${Partition}:kinesis:${Region}:${Account}:${StreamType}/${StreamName}/consumer/${ConsumerName}:${ConsumerCreationTimpstamp}
입니다. -
AWS 역할 ARN: AWS 역할의 ARN입니다. 역할의 ARN 형식은
arn:aws:iam::${Account}:role/${RoleName}
입니다. -
서비스 계정: 사용자가 만든 서비스 계정입니다.
-
-
업데이트를 클릭합니다.
gcloud
-
In the Trusted Cloud console, activate Cloud Shell.
At the bottom of the Trusted Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
다음 샘플에 언급된 모든 플래그를 사용하여
gcloud pubsub topics update
명령어를 실행합니다.gcloud pubsub topics update TOPIC_ID
--kinesis-ingestion-stream-arn KINESIS_STREAM_ARN
--kinesis-ingestion-consumer-arn KINESIS_CONSUMER_ARN
--kinesis-ingestion-role-arn KINESIS_ROLE_ARN
--kinesis-ingestion-service-account PUBSUB_SERVICE_ACCOUNT다음을 바꿉니다.
-
TOPIC_ID은 주제 ID 또는 이름입니다. 이 필드는 업데이트할 수 없습니다.
-
KINESIS_STREAM_ARN은 Pub/Sub로 수집하려는 Kinesis Data Streams의 ARN입니다. ARN 형식은
arn:${Partition}:kinesis:${Region}:${Account}:stream/${StreamName}
입니다. -
KINESIS_CONSUMER_ARN은 AWS Kinesis Data Streams에 등록된 소비자 리소스의 ARN입니다. ARN 형식은
arn:${Partition}:kinesis:${Region}:${Account}:${StreamType}/${StreamName}/consumer/${ConsumerName}:${ConsumerCreationTimpstamp}
입니다. -
KINESIS_ROLE_ARN은 AWS 역할의 ARN입니다. 역할의 ARN 형식은
arn:aws:iam::${Account}:role/${RoleName}
입니다. -
PUBSUB_SERVICE_ACCOUNT은 사용자가 만든 서비스 계정입니다.
-
Go
다음 샘플에서는 Go Pub/Sub 클라이언트 라이브러리의 주요 버전 (v2)을 사용합니다. 아직 v1 라이브러리를 사용하고 있다면 v2로의 마이그레이션 가이드를 참고하세요. v1 코드 샘플 목록을 보려면 지원 중단된 코드 샘플을 참고하세요.
이 샘플을 시도하기 전에 빠른 시작: 클라이언트 라이브러리 사용의 Go 설정 안내를 따르세요. 자세한 내용은 Pub/Sub Go API 참고 문서를 참조하세요.
자바
이 샘플을 시도하기 전에 빠른 시작: 클라이언트 라이브러리 사용의 Java 설정 안내를 따르세요. 자세한 내용은 Pub/Sub 자바 API 참조 문서를 참조하세요.
Node.js
이 샘플을 시도하기 전에 빠른 시작: 클라이언트 라이브러리 사용의 Node.js 설정 안내를 따르세요. 자세한 내용은 Pub/Sub Node.js API 참조 문서를 참조하세요.
Python
이 샘플을 시도하기 전에 빠른 시작: 클라이언트 라이브러리 사용의 Python 설정 안내를 따르세요. 자세한 내용은 Pub/Sub Python API 참조 문서를 참조하세요.
C++
이 샘플을 시도하기 전에 빠른 시작: 클라이언트 라이브러리 사용의 C++ 설정 안내를 따르세요. 자세한 내용은 Pub/Sub C++ API 참고 문서를 확인하세요.
Node.ts
이 샘플을 시도하기 전에 빠른 시작: 클라이언트 라이브러리 사용의 Node.js 설정 안내를 따르세요. 자세한 내용은 Pub/Sub Node.js API 참조 문서를 참조하세요.
ARN에 관한 자세한 내용은 Amazon 리소스 이름(ARN)과 IAM 식별자를 참조하세요.
표준 주제를 Cloud Storage 가져오기 주제로 변환
표준 주제를 Cloud Storage 가져오기 주제로 변환하려면 먼저 모든 기본 요건을 충족하는지 확인합니다.
콘솔
-
Trusted Cloud 콘솔에서 주제 페이지로 이동합니다.
-
Cloud Storage 가져오기 주제로 변환할 주제를 클릭합니다.
-
주제 세부정보 페이지에서 수정을 클릭합니다.
-
수집 사용 설정 옵션을 선택합니다.
-
수집 소스로 Google Cloud Storage를 선택합니다.
-
Cloud Storage 버킷의 경우 찾아보기를 클릭합니다.
버킷 선택 페이지가 열립니다. 다음 옵션 중 하나를 선택합니다.
-
적절한 프로젝트에서 기존 버킷을 선택합니다.
-
만들기 아이콘을 클릭하고 화면에 표시된 안내에 따라 새 버킷을 만듭니다. 버킷을 만든 후 Cloud Storage 가져오기 주제의 버킷을 선택합니다.
-
-
버킷을 지정하면 Pub/Sub에서 Pub/Sub 서비스 계정에 대한 버킷의 적절한 권한을 확인합니다. 권한 문제가 있으면 권한과 관련된 오류 메시지가 표시됩니다.
권한 문제가 발생하면 권한 설정을 클릭합니다. 자세한 내용은 Pub/Sub 서비스 계정에 Cloud Storage 권한 부여를 참고하세요.
-
객체 형식으로 텍스트, Avro 또는 Pub/Sub Avro를 선택합니다.
텍스트를 선택하면 객체를 메시지로 분할하는 데 사용할 구분자를 선택적으로 지정할 수 있습니다.
이러한 옵션에 대한 자세한 내용은 입력 형식을 참고하세요.
- 선택사항입니다. 주제에 최소 객체 생성 시간을 지정할 수 있습니다. 설정된 경우 최소 객체 생성 시간 이후에 생성된 객체만 수집됩니다.
자세한 내용은 최소 객체 생성 시간을 참고하세요.
- Glob 패턴을 지정해야 합니다. 버킷의 모든 객체를 수집하려면
**
를 glob 패턴으로 사용하세요. 지정된 패턴과 일치하는 객체만 수집됩니다.자세한 내용은 글로브 패턴 일치를 참고하세요.
- 다른 기본 설정은 유지합니다.
- 주제 업데이트를 클릭합니다.
gcloud
-
In the Trusted Cloud console, activate Cloud Shell.
At the bottom of the Trusted Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
가져오기 주제의 설정을 잃지 않으려면 주제를 업데이트할 때마다 모든 설정을 포함해야 합니다. 일부를 누락하면 Pub/Sub에서 설정을 원래 기본값으로 재설정합니다.
다음 샘플에 언급된 모든 플래그를 사용하여
gcloud pubsub topics update
명령어를 실행합니다.gcloud pubsub topics update TOPIC_ID \ --cloud-storage-ingestion-bucket=BUCKET_NAME\ --cloud-storage-ingestion-input-format=INPUT_FORMAT\ --cloud-storage-ingestion-text-delimiter=TEXT_DELIMITER\ --cloud-storage-ingestion-minimum-object-create-time=MINIMUM_OBJECT_CREATE_TIME\ --cloud-storage-ingestion-match-glob=MATCH_GLOB
다음을 바꿉니다.
-
TOPIC_ID은 주제 ID 또는 이름입니다. 이 필드는 업데이트할 수 없습니다.
-
BUCKET_NAME: 기존 버킷의 이름을 지정합니다. 예를 들면
prod_bucket
입니다. 버킷 이름에 프로젝트 ID를 포함해서는 안 됩니다. 버킷을 만들려면 버킷 만들기를 참조하세요. -
INPUT_FORMAT: 수집되는 객체의 형식을 지정합니다. 이 값은
text
,avro
또는pubsub_avro
입니다. 이러한 옵션에 대한 자세한 내용은 입력 형식을 참고하세요. -
TEXT_DELIMITER: 텍스트 객체를 Pub/Sub 메시지로 분할하는 데 사용할 구분자를 지정합니다. 단일 문자여야 하며
INPUT_FORMAT
가text
인 경우에만 설정해야 합니다. 기본값은 줄바꿈 문자 (\n
)입니다.gcloud CLI를 사용하여 구분 기호를 지정할 때는 줄바꿈
\n
과 같은 특수 문자의 처리에 유의하세요. 구분자가 올바르게 해석되도록'\n'
형식을 사용합니다. 따옴표나 이스케이프 없이\n
를 사용하면 구분자가"n"
이 됩니다. -
MINIMUM_OBJECT_CREATE_TIME: 객체가 수집되려면 객체가 생성되어야 하는 최소 시간을 지정합니다. UTC 시간이어야 하며 형식은
YYYY-MM-DDThh:mm:ssZ
입니다. 예를 들면2024-10-14T08:30:30Z
입니다.0001-01-01T00:00:00Z
부터9999-12-31T23:59:59Z
까지의 모든 날짜(과거 또는 미래)가 유효합니다. -
MATCH_GLOB: 객체가 수집되려면 일치해야 하는 glob 패턴을 지정합니다. gcloud CLI를 사용하는 경우
*
문자가 포함된 일치 glob에는*
문자가\*\*.txt
형식으로 이스케이프 처리되어 있거나 전체 일치 glob이 따옴표("**.txt"
또는'**.txt'
)로 묶여 있어야 합니다. glob 패턴에 지원되는 문법에 대한 자세한 내용은 Cloud Storage 문서를 참고하세요.
-