Google BigQuery 확장 프로그램

<ph type="x-smartling-placeholder"></ph> 현재 Apigee Edge 문서를 보고 있습니다.
Apigee X 문서. 정보

<ph type="x-smartling-placeholder">

버전 1.0.0

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

기본 요건

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

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

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

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

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

Google BigQuery 정보

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

실습 안내를 보려면 Google BigQuery 빠른 시작 중 하나를 참조하세요.

작업

<ph type="x-smartling-placeholder">

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