Google BigQuery 확장 프로그램

Apigee Edge 문서입니다.
Apigee X 문서로 이동 정보

버전 2.0.0

BigQuery 테이블에 행을 삽입합니다. 테이블의 행을 나열합니다.

기본 요건

이 콘텐츠는 이 확장 프로그램을 구성하고 사용하는 방법을 참조합니다. ExtensionCallout 정책을 사용하여 API 프록시에서 확장 프로그램을 사용하려면 먼저 다음을 실행해야 합니다.

  1. 계정에 BigQuery API를 사용 설정했는지 확인합니다.

  2. 행을 삽입하려면 먼저 BigQuery dataset 및 테이블 (스키마 포함)을 만들어야 합니다.

  3. GCP Console을 사용하여 서비스 계정의 키를 생성합니다.

  4. 구성 참조를 사용하여 확장 프로그램을 추가 및 구성할 때 결과 키 JSON 파일의 콘텐츠를 사용합니다.

Google BigQuery 정보

Google BigQuery는 Google 인프라의 처리 능력을 사용하여 매우 빠른 SQL 쿼리를 실행할 수 있는 확장 가능한 서버리스 엔터프라이즈 데이터 웨어하우스입니다. 관리할 인프라가 없기 때문에 익숙한 SQL로 데이터를 분석해 의미 있고 유용한 정보를 찾는 데 집중할 수 있으며 데이터베이스 관리자가 필요하지 않습니다.

실무 안내는 Google BigQuery 빠른 시작 중 하나를 시도해 보세요.

작업

insert

삽입할 행과 데이터 세트/테이블 ID가 포함된 레코드 집합을 데이터 세트로 BigQuery에 직접 삽입합니다.

구문

<Action>insert</Action>
<Input><![CDATA[{
  "dataset" : dataset-to-insert,
  "table" : table-to-receive-data,
  "rows" : array-of-rows-to-insert
}]]></Input>

예

<Action>insert</Action>
<Input><![CDATA[{
  "dataset" : "TestData",
  "table" : "TestTable",
  "rows" : [
    {"technology":"CRISPR","inventorFirstName":"Jennifer","inventorLastName":"Doudna"},
    {"technology":"World Wide Web","inventorFirstName":"Tim","inventorLastName":"Berners-Lee"}
    {"technology":"Alternating current","inventorFirstName":"Nikola","inventorLastName":"Tesla"}
  ]
}]]></Input>

요청 매개변수

매개변수 설명 유형 기본값 필수
데이터 세트 BigQuery에 삽입할 데이터 세트의 ID입니다. 문자열 없음 예.
행 테이블에 삽입할 행입니다. 배열 없음 예.
테이블 데이터를 수신할 테이블의 이름입니다. 문자열 없음 예.

응답

없음

listRows

테이블 ID 및 데이터 세트 ID로 지정된 테이블의 행을 나열합니다.

구문

<Action>listRows</Action>
<Input><![CDATA[{
  "dataset" : ID-of-dataset-to-examine,
  "limit" : maximum-rows-to-list,
  "startIndex" : row-index-at-which-to-start-list
  "table" : ID-of-table-to-examine
}]]></Input>

예

<Action>listRows</Action>
<Input><![CDATA[{
  "dataset" : "TestData",
  "limit" : 2,
  "startIndex" : 1,
  "table" : "TestTable"
}]]></Input>

요청 매개변수

매개변수 설명 유형 기본값 필수
데이터 세트 행을 나열할 데이터 세트의 ID입니다. 문자열 없음 예.
제한 나열할 최대 행 수입니다. 정수 없음 아니요.
startIndex 목록을 시작할 행 색인입니다. 정수 없음 아니요.
테이블 행을 나열할 테이블의 ID입니다. 문자열 없음 예.

응답

rows 배열

{
  "rows": [
    {"technology":"World Wide Web","inventorFirstName":"Tim","inventorLastName":"Berners-Lee"}
    {"technology":"Alternating current","inventorFirstName":"Nikola","inventorLastName":"Tesla"}
  ]
}
매개변수 설명 유형 기본값 필수
행 요청에서 반환된 행 배열입니다. 배열 없음 예.

구성 참조

API 프록시에서 사용하도록 이 확장 프로그램을 구성하고 배포할 때 다음을 사용하세요. Apigee 콘솔을 사용하여 확장 프로그램을 구성하는 단계는 확장 프로그램 추가 및 구성을 참고하세요.

일반적인 확장 속성

모든 확장 프로그램에는 다음과 같은 속성이 있습니다.

속성 설명 기본 필수
name 확장 프로그램의 구성에 지정할 이름입니다. 없음 지원됨
packageName Apigee Edge에서 제공하는 확장 프로그램 패키지 이름입니다. 없음 지원됨
version 확장 프로그램을 구성하는 확장 프로그램 패키지의 버전 번호입니다. 없음 지원됨
configuration 추가하는 확장 프로그램 관련 구성 값입니다. 이 확장 프로그램 속성의 속성을 참조하세요. 없음 지원됨

이 확장 프로그램 패키지의 속성

이 확장 프로그램에만 해당하는 다음 구성 속성의 값을 지정합니다.

속성 설명 기본값 필수
projectId 데이터가 있는 GCP 프로젝트의 ID입니다. 없음 예.
사용자 인증 정보 Apigee Edge 콘솔에 입력하면 서비스 계정 키 파일의 콘텐츠가 됩니다. 관리 API를 통해 전송되는 경우 서비스 계정 키 파일에서 생성된 base64로 인코딩된 값입니다. 없음 예.