이 페이지에서는 Spanner JDBC 드라이버를 사용하여 Spanner에서 기본 작업을 수행하는 방법을 보여줍니다.
JDBC 드라이버 설치
Spanner 클라이언트 라이브러리의 절차에 따라 인증을 설정한 후 다음 스니펫에 표시된 Spanner JDBC 드라이버 종속 항목을 pom.xml
파일에 추가합니다.
JDBC 드라이버를 로드하기 위해 자바 클래스 이름이 필요한 프레임 워크를 사용하는 경우에는
com.google.cloud.spanner.jdbc.JdbcDriver
입니다. 연결 설정 방법은 JdbcDriver용 API 참고 리소스를 참조하세요.
Spanner 데이터베이스에 연결
JdbcDriver 클래스 설명은 연결 문자열 문법을 보여주고 연결을 만들고 쿼리를 실행하기 위한 샘플 코드가 포함되어 있습니다.
드라이버는 지정된 데이터베이스의 SQL 언어(GoogleSQL 또는 PostgreSQL)를 자동으로 감지합니다. 언어 매개변수는 필요하지 않거나 허용되지 않습니다.
에뮬레이터에 연결
에뮬레이터에 연결하려면 SPANNER_EMULATOR_HOST
환경 변수를 설정합니다. 예를 들면 다음과 같습니다.
Linux/Mac OS
export SPANNER_EMULATOR_HOST=localhost:9010
Windows
set SPANNER_EMULATOR_HOST=localhost:9010
이렇게 하면 Spanner JDBC 드라이버가 기본 프로덕션 서비스 대신 localhost
에서 실행되는 에뮬레이터에 연결됩니다.
예시
다음 코드 예시에서는 몇 가지 일반적인 사용 사례를 다룹니다.
스키마 업데이트 실행
다음 코드 예시에서는 먼저 JDBC 연결을 만든 다음 테이블을 만들어 Singers
테이블을 데이터베이스에 추가합니다.
자동 커밋 모드에서 트랜잭션을 사용하여 행 추가
여러 작업을 그룹으로 커밋할 필요가 없는 경우 트랜잭션을 기본 동작인 자동 커밋 모드에서 사용할 수 있습니다. 다음 코드 예시에서는 자동 커밋 모드에서 트랜잭션을 사용하여 Singers
테이블에 행을 추가합니다.
그룹으로 여러 작업이 커밋되는 방식 제어
Spanner에서 여러 작업을 그룹으로 함께 커밋할지 여부를 제어하려면 자동 커밋 모드를 중지하면 됩니다. 다음 코드 예시에서는 connection.setAutoCommit(false)
및 connection.commit()
을 사용하여 Singers
테이블에 행을 추가합니다.
SQL 쿼리 실행
다음 코드 예에서는 Singers
테이블의 모든 행을 가수의 성을 기준으로 정렬합니다.
다음 단계
- Spanner JDBC 드라이버에 대한 자주 묻는 질문(FAQ)과 답변 확인
- Spanner JDBC 드라이버 세션 관리 명령어 알아보기