Google BigQuery 확장 프로그램

현재 Apigee Edge 문서가 표시되고 있습니다.
Apigee X 문서로 이동 정보

버전 1.0.0

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

기본 요건

이 콘텐츠는 이 확장 프로그램을 구성하고 사용하기 위한 참조를 제공합니다. Extension콜아웃 정책을 사용하여 API 프록시의 확장 프로그램을 사용하려면 다음 요건을 충족해야 합니다.

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

  2. 행 삽입을 시도하기 전에 BigQuery 데이터 세트 및 테이블 (스키마 포함)을 만들었는지 확인하세요.

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

  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로 인코딩된 값입니다. 없음 예.