PostgreSQL Internals(2)

Transcription

1 2014 年 7 月 16 日 作 成 2015 年 3 月 4 日 改 定 PostgreSQL Internals (2) 日 本 ヒューレット パッカード 株 式 会 社 篠 田 典 良 1

2 謝 辞 本 資 料 の 作 成 と 公 開 にあたり 永 安 悟 史 様 (アップタイム テクノロジーズ 合 同 会 社 ) 渡 部 亮 太 様 ( 株 式 会 社 コーソル)にレビューいただきました アドバイスありがとうござ いました 日 本 ヒューレット パッカード 株 式 会 社 の 社 内 では 高 橋 智 雄 さん 北 山 貴 広 さん 竹 島 彰 子 さん(いずれもテクノロジー 事 業 統 括 サービス 統 括 本 部 )にレビューいただきました ありがとうございます 更 新 版 の 作 成 にあたり 永 安 悟 史 様 渡 部 亮 太 様 高 橋 智 雄 さん 北 山 貴 広 さん 竹 島 彰 子 さんにあらためてご 意 見 をいただきました ありがとうございます オープンソース 製 品 を 開 発 するすべてのエンジニアに 感 謝 します 本 文 書 が 少 しでも PostgreSQL を 利 用 する 皆 様 の 役 に 立 ちますように 2014 年 7 月 16 日 作 成 2015 年 3 月 4 日 改 定 篠 田 典 良 2

3 目 次 謝 辞... 2 目 次... 3 用 語 集 本 文 書 について 本 文 書 の 目 的 本 文 書 の 対 象 読 者 本 文 書 の 範 囲 本 文 書 の 対 応 バージョン 本 文 書 の 更 新 本 文 書 に 対 する 質 問 意 見 および 責 任 表 記 表 記 の 変 換 例 の 表 記 JDBC Driver Connection オブジェクトの 使 用 方 法 接 続 プロパティの 設 定 方 法 接 続 プロパティの 一 覧 preparethreshold プロパティ loglevel プロパティ readonly プロパティ sendbuffersize, receivebuffersize プロパティ ApplicationName プロパティ ssl プロパティ stringtype プロパティ logunclosedconnections プロパティ disablecolumnsanitiser プロパティ unknownlength プロパティ currentschema プロパティ DataSource オブジェクトの 使 用 方 法 DataSource オブジェクトの 実 装 接 続 プロパティ 接 続 プール ログの 出 力

4 2.3 ロードバランス 機 能 複 数 ホストの 指 定 loadbalancehosts プロパティ targetservertype プロパティ hostrecheckseconds プロパティ ResultSet の 列 名 Fetch Size の 設 定 メモリー 使 用 実 行 計 画 の 変 化 未 実 装 の 機 能 ドライバー 実 装 クラス 追 加 モジュール postgres_fdw postgres_fdw とは postgres_fdw の 使 用 方 法 実 行 される SQL 接 続 時 に 使 用 される 情 報 pg_stat_statements pg_stat_statements の 概 要 pg_stat_statements の 仕 様 pg_stat_statements ビュー auto_explain auto_explain の 概 要 auto_explain の 仕 様 pg_hint_plan pg_hint_plan の 概 要 ヒント 記 述 時 の 注 意 点 IndexScan の 注 意 点 結 合 ヒントの 注 意 点 Leading ヒントと Rows ヒント ログ テーブル ヒント pg_rman pg_rman の 概 要 pg_rman の 使 用 差 分 バックアップ 検 証

5 3.6 passwordcheck passwordcheck の 概 要 チェックされる 内 容 CrackLib との 統 合 pg_upgrade pg_upgrade の 概 要 pg_upgrade の 実 行 手 順 互 換 性 の 検 証 アップグレードの 実 行 内 部 構 造 リンクモードの 動 作 テーブル 空 間 の 移 行 pgstattuple pgstattuple の 概 要 pgstattuple 関 数 pgstatindex 関 数 / pgstatginindex 関 数 pg_relpages 関 数 付 録. 参 考 文 献 付 録 1. 書 籍 付 録 2. URL 変 更 履 歴

6 用 語 集 表 1 略 語 / 用 語 略 語 / 用 語 contrib モジュール GUC JDBC LSN OID(オブジェクト ID) PL/pgSQL PostgreSQL 説 明 PostgreSQL の 拡 張 モジュールを 指 す 標 準 で 使 用 できる contrib モ ジ ュ ー ル の 一 覧 は マ ニ ュ ア ル Appendix F. Additional Supplied Modules 1 に 掲 載 されている PostgreSQL のパラメータが 保 存 されるメモリー 領 域 (Global Unified Configuration) Java アプリケーションから RDBMS を 利 用 するための 標 準 API とクラス Log Serial Number を 指 す 仮 想 的 なトランザクション ログ の 書 き 込 み 位 置 を 示 す データベース 内 部 で 作 成 されるオブジェクトを 識 別 する ID で 符 号 なし 32 ビット 値 を 持 つ PostgreSQL のストアド プロシージャ 記 述 言 語 のひとつ Oracle Database の PL/SQL とある 程 度 互 換 性 がある オープンソースデータベース 製 品 psql TID (Tuple ID) WAL XID(トランザクション ID) アーカイブログ PostgreSQL に 付 属 する SQL 文 を 実 行 するためのユーティリ ティ テーブル 内 のレコードを 一 意 に 示 す ID レコードの 物 理 位 置 を 示 す PostgreSQL の ト ラ ン ザ ク シ ョ ン ロ グ ( Write Ahead Logging)ファイル トランザクションを 一 意 に 識 別 する ID レコードの 新 旧 を 識 別 する 符 号 なし 32 ビット 値 リカバリに 使 用 される WAL のコピー システム カタログ タプル PostgreSQL データベース 全 体 のメタ 情 報 を 格 納 している 領 域 テーブル 内 のレコードを 示 す 1 6

7 表 1( 続 ) 略 語 / 用 語 略 語 / 用 語 データベース クラスタ リレーション 説 明 PostgreSQL データベース 全 体 の 管 理 情 報 が 格 納 されている ディレクトリ テーブルをリレーションと 呼 ぶ 場 合 がある テーブル 空 間 オブジェクトが 格 納 されるファイルシステム 上 のディレクト リ 表 領 域 と 呼 ばれる 場 合 もある 7

8 1. 本 文 書 について 1.1 本 文 書 の 目 的 本 文 書 は PostgreSQL を 利 用 するエンジニア 向 けに PostgreSQL 周 辺 ソフトウェアの 内 部 構 造 やマニュアルに 記 載 されていない 動 作 に 関 する 知 識 を 提 供 することを 目 的 としてい ます 1.2 本 文 書 の 対 象 読 者 本 文 書 は 既 にある 程 度 PostgreSQL に 関 する 知 識 を 持 っているエンジニア 向 けに 記 述 しています インストール 基 本 的 な 管 理 等 は 実 施 できることを 前 提 としています 1.3 本 文 書 の 範 囲 本 文 書 の 記 述 範 囲 は PostgreSQL にアクセスする JDBC Driver contrib モジュール お よび 頻 繁 に 使 用 される PostgreSQL 追 加 モジュールの 一 部 を 範 囲 としています PostgreSQL 本 体 の 内 部 構 造 については 本 文 書 の 姉 妹 編 である PostgreSQL Internals (1) を 参 照 してください 内 容 については 作 成 者 が 独 習 用 に 調 査 した 結 果 をまとめた 資 料 であ るため 技 術 レベルや 網 羅 性 にばらつきがあります 1.4 本 文 書 の 対 応 バージョン 本 文 書 は 原 則 として 以 下 のバージョンを 対 象 としています 表 2 対 象 バージョン 種 別 バージョン 備 考 データベース PostgreSQL オペレーティング Red Hat Enterprise Linux 6 Update 5 (x86-64) システム Java Runtime OpenJDK Runtime Environment 1.7.0_45 JDBC Driver PostgreSQL JDBC Driver jdbc41 pg_hint_plan pg_rman

9 1.5 本 文 書 の 更 新 本 文 書 は 要 望 があれば 更 新 する 予 定 ですが 時 期 や 更 新 内 容 は 決 定 していません 1.6 本 文 書 に 対 する 質 問 意 見 および 責 任 本 文 書 の 内 容 は 日 本 ヒューレット パッカード 株 式 会 社 の 公 式 見 解 ではありません ま た 内 容 の 間 違 いにより 生 じた 問 題 について 作 成 者 および 所 属 会 社 は 責 任 を 負 いません 本 文 書 に 対 するご 意 見 ご 感 想 等 については 日 本 ヒューレット パッカード 株 式 会 社 テクノ ロジーコンサルティング 事 業 統 括 篠 田 典 良 知 らせく ださい 1.7 表 記 表 記 の 変 換 中 括 弧 ({})で 囲 まれた 部 分 は 何 等 かの 文 字 列 に 変 換 されることを 示 しています 以 下 の 表 記 を 使 用 します 表 3 表 記 表 記 説 明 例 {HOSTNAME} ホスト 名 dbhost1 {OID} 任 意 の OID 番 号 {INSTALL} PostgreSQL インストール ディ /opt/postgresql/9.4 レクトリ {PGDATA} データベース クラスタ 用 ディレ /opt/postgresql/9.4/data クトリ {PGDATABASE} 接 続 先 ディレクトリ 名 postgres {PORT} 接 続 待 ちポート 番 号 5432 {SPACE} 空 白 (0x20)の 入 力 {SQL} 任 意 の SQL 文 SELECT * FROM table1 {TAB} タブ(0x09)の 入 力 {PASSWORD} 表 示 されないパスワードの 入 力 secret ${ 文 字 列 } 環 境 変 数 が 展 開 されることを 示 す ${PGDATA} 9

10 1.7.2 例 の 表 記 本 文 書 内 にはコマンドや SQL 文 の 実 行 例 が 含 まれます 例 は 以 下 の 表 記 で 記 載 していま す 表 4 例 の 表 記 表 記 説 明 備 考 # Linux root ユーザーのプロンプト $ Linux 一 般 ユーザーのプロンプト 太 字 ユーザーが 入 力 する 文 字 列 postgres=# PostgreSQL 管 理 者 が 利 用 する psql プロンプト postgres=> PostgreSQL 一 般 ユーザーが 利 用 する psql プロンプト 10

11 2. JDBC Driver Java アプリケーションから PostgreSQL データベースに 対 してアクセスする 標 準 として JDBC Driver を 使 う 方 法 があります ここでは JDBC Driver を 使 用 する 上 で 注 意 が 必 要 な 点 を 記 述 しています 2.1 Connection オブジェクトの 使 用 方 法 PostgreSQL インスタンスに 対 して Connection オブジェクトを 使 って 接 続 を 行 う 場 合 いくつかの 接 続 プロパティを 指 定 することができます 接 続 プロパティの 設 定 方 法 java.sql.drivermanager クラスの getconnection メソッドには データベース 接 続 のた めに 必 要 な 情 報 として url(string)パラメータを 指 定 します url パラメータは 以 下 の 形 式 の 文 字 列 です ホスト 名 を 省 略 した 場 合 はローカルホストを ポート 番 号 を 省 略 した 場 合 は 5432 が 使 用 されます JDBC Driver 9.4 では 複 数 ホスト 名 を 記 述 できるようになりま した 検 証 結 果 は 後 述 します 例 1 URL 指 定 形 式 jdbc:postgresql:{pgdatabase} jdbc:postgresql://{hostname}/{pgdatabase} jdbc:postgresql://{hostname}:{port}/{pgdatabase} url パラメータによるプロパティ 設 定 上 記 url パラメータには 追 加 情 報 としてプロパティを 指 定 することができます データベ ース 名 の 後 にクエスチョン マーク(?)を 指 定 し プロパティ 名 = 値 の 形 式 で 記 述 され るセットをアンパーサンド(&)で 結 合 します 下 記 は user, password, ssl プロパティを 指 定 した 例 です 例 2 プロパティ 指 定 jdbc:postgresql:appldb1?user=postgres&password=secret&ssl=true プロパティ 名 と 値 のセットを java.util.properties オブジェクトに 格 納 して 接 続 時 に 指 定 することもできます 間 違 ったプロパティ 名 やプロパティ 値 を 指 定 しても 接 続 エラーは 発 生 しません プロパティ 値 が 認 識 できない 場 合 はクライアント 側 のログに 警 告 が 出 力 さ れます また url に 指 定 する 要 素 はすべて 大 文 字 / 小 文 字 を 区 別 します 11

12 ファイルによるプロパティ 設 定 プロパティは 特 定 のファイル 内 に 記 述 することもできます 環 境 変 数 CLASSPATH に 含 まれるディレクトリ 以 下 に org/postgresql/driverconfig.properties ファイルを 配 置 し ファイル 内 の 各 行 に プロパティ 名 = 値 の 形 式 でプロパティを 記 述 します ただしこのフ ァイルはインスタンスに 対 する 接 続 後 に 参 照 されるため ssl プロパティのような 接 続 時 に 使 用 されるプロパティは 記 述 できません 12

13 2.1.2 接 続 プロパティの 一 覧 URL には 以 下 のプロパティを 指 定 することができます 表 5 プロパティの 一 覧 (オンライン マニュアルに 記 載 されている) プロパティ 説 明 デフォルト 値 user 接 続 ユーザー 名 OS ユーザー 名 2 password 接 続 パスワード - ssl SSL 接 続 を 使 用 するか false sslfactory SSL 接 続 情 報 - sslfactoryarg SSL 接 続 パラメータ - compatible 互 換 性 情 報 9.4 sendbuffersize 送 信 バッファ サイズ -1 receivebuffersize 受 信 バッファ サイズ -1 protocolversion 接 続 プロトコルのバージョン 0 loglevel ログ 出 力 レベル 0 charset 文 字 コード UTF-8 allowencodingchanges エンコードの 変 更 を 許 可 false logunclosedconnections 閉 じられていない Connection をログ false preparethreshold Server Prepare Statement を 使 用 する 閾 5 値 logintimeout ログイン タイムアウト 0 sockettimeout ソケット 読 み 込 みタイムアウト 0 tcpkeepalive Keep Alive の 使 用 false unknownlength 不 定 サイズ 列 の 長 さ 指 定 stringtype 文 字 列 のデータ 型 指 定 varchar kerberosservername GSSAPI 認 証 サーバー 名 - jaasapplicationname JAAS システム 名 - currentschema 3 デフォルト スキーマ 名 null targetservertype 接 続 先 インスタンスのタイプ any hostrecheckseconds ホストの 再 チェック 間 隔 10 loadbalancehosts ロードバランスを 行 うか false 2 System.getProperty("user.name")の 値 が 使 用 されます 3 currentschema, targetservertype, loadbalancehosts, hostrecheckseconds プロパティは PostgreSQL JDBC Driver 9.4 から 追 加 されました 13

14 表 5( 続 )プロパティの 一 覧 (オンライン マニュアルに 記 載 されている) プロパティ 説 明 デフォルト 値 gsslib Java GSS ライブラリ 関 連 auto sspiserviceclass SSPI 認 証 関 連? POSTGRES ApplicationName アプリケーション 名 - binarytransferenable バイナリ 転 送 有 効 データ 型 binarytransferdisable バイナリ 転 送 無 効 データ 型 - connecttimeout 接 続 タイムアウト 0 usespnego SPNEGO を 使 用 false readonly 読 み 取 り 専 用 false disablecolumnsanitiser 列 のサニタイザーを 無 効 にする false assumeminserverversion 接 続 可 能 な 最 低 バージョン - 以 下 のプロパティはオンライン マニュアルには 記 載 されていませんが ソースコード 上 には 実 装 されています 一 部 を 除 いて 動 作 の 検 証 は 行 っていません 表 6 プロパティの 一 覧 (オンライン マニュアルに 記 載 されていない) プロパティ 説 明 デフォルト 値 binarytransfer バイナリ 転 送 の 有 効 化 true sslmode SSL モード - sslcert SSL 証 明 - sslkey SSL キー - sslpasswordcallback SSL パスワード コールバック - sslpassword SSL パスワード - sslrootcert SSL ルート 証 明 - sslhostnameverifier SSL ホスト 名 preparethreshold プロパティ preparethreshold プロパティは 同 一 SQL 文 を 複 数 回 実 行 した 場 合 に 自 動 的 に Server Prepare Statement(PREPARE 文 )を 使 用 する 閾 値 を 指 定 します デフォルト 値 は 5 です このため 5 回 目 の SQL 文 実 行 から Server Prepare Statement が 使 用 されます 設 定 は 以 下 の 方 法 で 変 更 できます 14

15 接 続 URL に 指 定 する Connection オブジェクトから PGConnection オブジェクトを 取 得 し setpreparethreshold メソッドで 指 定 する Statement オブジェクトから PGStatement オブジェクトを 取 得 し setpreparethreshold メソッドで 指 定 する preparethreshold プロパティで 指 定 した SQL 文 の 実 行 回 数 は Statement オブジェクト 単 位 で 計 算 されます このため 同 一 の SQL 文 を 異 なる Statement オブジェクトで 実 行 して も Server Prepare Statement は 使 用 されません 以 下 の 例 は 単 一 の PreparedStatement オブジェクトのバインド 変 数 を 変 更 しながら 5 回 実 行 しています preparethreshold プロパティを 3 に 指 定 し PostgreSQL インスタン スの log_statement パラメータを all に 設 定 した 場 合 のログです 例 3 preparethreshold 実 行 時 のサーバー ログ LOG: execute <unnamed>: SELECT COUNT(*) FROM bind1 WHERE c2=$1 DETAIL: parameters: $1 = 'maj' LOG: execute <unnamed>: SELECT COUNT(*) FROM bind1 WHERE c2=$1 DETAIL: parameters: $1 = 'min' LOG: execute S_1: SELECT COUNT(*) FROM bind1 WHERE c2=$1 DETAIL: parameters: $1 = 'maj' LOG: execute S_1: SELECT COUNT(*) FROM bind1 WHERE c2=$1 DETAIL: parameters: $1 = 'min' LOG: execute S_1: SELECT COUNT(*) FROM bind1 WHERE c2=$1 DETAIL: parameters: $1 = 'maj' 3 回 目 の LOG:から <unnamed> 部 分 が S_1 に 変 化 して Server Prepared Statement が 利 用 されていることがわかります loglevel プロパティ loglevel プロパティはクライアント 側 のログ 出 力 のレベルを 指 定 します デフォルト 値 は 0 で ロ グ 出 力 を 行 い ま せ ん 有 効 な 値 は 1 ( =org.postgresql.driver.info ) 2 (=org.postgresql.driver.debug)です 2 以 上 の 整 数 を 指 定 してもエラーは 発 生 せず 2 と 見 なされます 整 数 値 以 外 の 値 4を 指 定 すると org.postgresql.util.psqlexception 例 外 が 発 生 します loglevel=2 を 指 定 すると JDBC Driver を 使 った 各 種 メソッドの 実 行 単 位 で 詳 細 なログが 4 Integer#parseInt メソッドが 例 外 を 発 生 させる 場 合 15

16 出 力 されます 以 下 の 例 は 特 定 のメソッドを 実 行 した 場 合 に 出 力 されるログです 例 4 DriverManager#getConnection メソッド 実 行 時 07:35: (1) PostgreSQL 9.4 JDBC4.1 (build 1200) 07:35: (1) Trying to establish a protocol version 3 connection to localhost: :35: (1) Receive Buffer Size is :35: (1) Send Buffer Size is :35: (1) FE=> StartupPacket(user=demo, database=demodb, client_encoding=utf8, DateStyle=ISO, TimeZone=Asia/Tokyo, extra_float_digits=2) 07:35: (1) <=BE AuthenticationOk 07:35: (1) <=BE ParameterStatus(application_name = ) 07:35: (1) <=BE ParameterStatus(client_encoding = UTF8) << 途 中 省 略 >> 07:35: (1) <=BE ReadyForQuery(I) 07:35: (1) compatible = :35: (1) loglevel = 2 07:35: (1) prepare threshold = 5 07:35: (1) types using binary send = INT8_ARRAY,TIMESTAMPTZ,FLOAT4_ARRAY,FLOAT8_ARRAY,UUID,TEXT_ARRAY,VARCHAR_ARRAY,BYTEA,TIME,FLOAT4,FLOAT8,INT2_ARRAY,TIMETZ,INT2,INT8,INT4,INT4_ARRAY,TIMESTAM P,POINT,BOX 07:35: (1) types using binary receive = INT8_ARRAY,TIMESTAMPTZ,FLOAT4_ARRAY,FLOAT8_ARRAY,UUID,TEXT_ARRAY,VARCHAR_ARRAY,BYTEA,TIME,DATE,FLOAT4,FLOAT8,INT2_ARRAY,TIMETZ,INT2,INT8,INT4,INT4_ARRAY,TIM ESTAMP,POINT,BOX 07:35: (1) integer date/time = true getconnection returning org.postgresql.driver 16

17 例 5 PreparedStatement#executeQuery メソッド 実 行 時 07:35: (1) simple execute, handler=org.postgresql.jdbc2.abstractjdbc2statement$statementresulthandler@566 fbd76, maxrows=0, fetchsize=0, flags=17 07:35: (1) FE=> Parse(stmt=null,query="SELECT COUNT(*) FROM bind1 WHERE c2=$1",oids={1043}) 07:35: (1) FE=> Bind(stmt=null,portal=null,$1=<'maj'>) 07:35: (1) FE=> Describe(portal=null) 07:35: (1) FE=> Execute(portal=null,limit=0) 07:35: (1) FE=> Sync 07:35: (1) <=BE ParseComplete [null] 07:35: (1) <=BE BindComplete [null] 07:35: (1) <=BE RowDescription(1) 07:35: (1) Field(,INT8,8,T) 07:35: (1) <=BE DataRow(len=5) 07:35: (1) <=BE CommandStatus(SELECT 1) 07:35: (1) <=BE ReadyForQuery(I) readonly プロパティ readonly プロパティは JDBC Driver 9.3 から 利 用 できましたが ドキュメントには 記 述 がありませんでした JDBC Driver 9.4 からマニュアルに 記 載 されました boolean 値 を 取 り デフォルト 値 は false です true を 指 定 すると 更 新 系 の SQL 文 を 実 行 すると 以 下 の 例 外 が 発 生 します 例 6 readonly=true 指 定 時 の 例 外 (Exception#printStackTrace メソッドで 出 力 ) Exception in thread "main" org.postgresql.util.psqlexception: ERROR: cannot execute INSERT in a read-only transaction at org.postgresql.core.v3.queryexecutorimpl.receiveerrorresponse(queryexecutorimpl.java:2270) at org.postgresql.core.v3.queryexecutorimpl.processresults(queryexecutorimpl.java:1998) at org.postgresql.core.v3.queryexecutorimpl.execute(queryexecutorimpl.java:255) at org.postgresql.jdbc2.abstractjdbc2statement.execute(abstractjdbc2statement.java:570) at org.postgresql.jdbc2.abstractjdbc2statement.executewithflags(abstractjdbc2statement.java:406) at org.postgresql.jdbc2.abstractjdbc2statement.execute(abstractjdbc2statement.java:398) at bind1a.main(bind1a.java:39) 17

18 2.1.6 sendbuffersize, receivebuffersize プロパティ ソケットの 送 信 バッファと 受 信 バッファのサイズを 指 定 します デフォルト 値 は-1 で システム デフォルトを 使 用 します 最 大 値 は 以 下 のカーネル パラメータに 依 存 します カーネル パラメータの 値 よりも 大 きい 値 を 指 定 した 場 合 でもエラーは 発 生 せず カーネ ル パラメータの 値 が 使 用 されます 表 7 sendbuffersize, receivebuffersize プロパティの 制 限 プロパティ 上 限 を 決 めるカーネル パラメータ 上 限 のデフォルト 値 sendbuffersize net.core.wmem_max 124,928 receivebuffersize net.core.rmem_max 124,928 公 式 なマニュアル( 一 部 プロパティ 名 として recvbuffersize と 示 されていますが 実 装 は receivebuffersize です Red Hat Enterprise Linux 6.5 / OpenJDK 環 境 ではプロパティのデフォルト 値 の 検 証 結 果 は 以 下 の 通 りです 表 8 sendbuffersize, receivebuffersize プロパティのデフォルト プロパティ デフォルト 値 備 考 sendbuffersize 84,580 receivebuffersize 43,690 パラメータ 値 の 確 認 設 定 値 を 確 認 するためには loglevel プロパティを 1 または 2 に 設 定 します 以 下 のログ が 出 力 されます 例 7 sendbuffersize / receivebuffersize プロパティの 確 認 06:52: (1) PostgreSQL 9.4 JDBC4.1 (build 1200) 06:52: (1) Trying to establish a protocol version 3 connection to localhost: :52: (1) Receive Buffer Size is :52: (1) Send Buffer Size is

19 2.1.7 ApplicationName プロパティ ApplicationName プロパティは JDBC Driver 9.4 からマニュアルには 記 述 が 追 加 されま した デフォルト 値 は 空 文 字 です プロパティに 文 字 列 を 指 定 すると pg_stat_activity カ タログの application_name 列 に 指 定 値 が 表 示 されるようになります ssl プロパティ ssl プロパティを true に 指 定 するとクライアントとサーバー 間 の 通 信 に SSL が 使 用 され るようになります PostgreSQL インスタンスが SSL に 対 応 していない 場 合 接 続 は 失 敗 します 例 8 サーバーが SSL に 対 応 していないエラー(Exception) Exception in thread "main" org.postgresql.util.psqlexception: The server does not support SSL. at org.postgresql.core.v3.connectionfactoryimpl.enablessl(connectionfactoryimpl.j ava:322) << 以 下 省 略 >> stringtype プロパティ PrepareStatement#setString メソッドのデータ 型 を 指 定 します 指 定 できる 値 は varchar(デフォルト 値 )または unspecified です パラメータ 値 は 大 文 字 / 小 文 字 を 意 識 しません varchar または unspecified 以 外 の 値 を 指 定 すると 以 下 の 例 外 が 発 生 します 例 9 stringtype プロパティ 値 のエラー(Exception) org.postgresql.util.psqlexception: Unsupported value for stringtype parameter: BADVALUE logunclosedconnections プロパティ デフォルト 値 は false です true に 設 定 すると Java VM の GC により finalize メソッド がコールされた 場 合 close メソッドが 呼 ばれていない Connection メソッドの 情 報 をログ に 出 力 します 以 下 のログが 出 力 されますが 動 作 は 未 確 認 です 例 10 logunclosedconnections プロパティ 関 連 ログ Finalizing a Connection that was never closed: 19

20 20

21 disablecolumnsanitiser プロパティ このプロパティは JDBC Driver 9.4 からオンライン ドキュメントに 記 述 が 追 加 されま した boolean 値 を 取 り デフォルト 値 は false です ResultSet#get*(String) メソッドは 内 部 的 に 列 名 から 列 番 号 へ 変 換 するハッシュ テ ーブルを 作 成 します 標 準 では 列 名 を 小 文 字 に 変 換 してハッシュ テーブルを 作 成 してい ます disablecolumnsanitiser プロパティを true に 設 定 すると 列 名 の 小 文 字 変 換 の 処 理 をスキップします テーブルに 大 文 字 / 小 文 字 のみ 異 なる 列 名 が 存 在 する 場 合 に 影 響 を 受 ける 場 合 があります unknownlength プロパティ text 型 等 サ イ ズ が 決 ま っ て い な い 列 の デ ー タ 型 に 対 し て ResultSetMetaData#getColumnDisplaySize メ ソ ッ ド や ResultSetMetaData#getPrecision メソッド 実 行 時 に 返 る 値 を 返 します デフォルト 値 は Integer.MAX_VALUE(2,147,483,647)です 数 値 は 整 数 であればマイナスの 値 でも 受 け 付 けますが 整 数 以 外 を 指 定 すると 以 下 のエ ラーが 発 生 します 例 11 unknownlength プロパティ 値 のエラー(Exception) org.postgresql.util.psqlexception: unknownlength parameter value must be an integer currentschema プロパティ currentschema プロパティはデフォルトのスキーマ 名 を 設 定 します PostgreSQL JDBC Driver 9.4 で 追 加 されました このプロパティを 指 定 すると パラメータ search_path は 無 効 になります このため search_path に 含 まれるスキーマ 内 のテーブルにアクセスする SQL には スキーマ 名 の 修 飾 が 必 要 になります 21

22 2.2 DataSource オブジェクトの 使 用 方 法 JDBC Driver を 使 って PostgreSQL インスタンスに 接 続 する 方 法 として DriverManager オブジェクトを 使 用 する 方 法 と DataSource オブジェクトを 使 用 する 方 法 があります こ こでは DataSource オブジェクトを 使 用 する 方 法 について 説 明 しています DataSource オブジェクトの 実 装 PostgreSQL JDBC Driver には 複 数 の DataSource オブジェクトが 提 供 されています 接 続 プールの 機 能 によって 以 下 の2オブジェクトを 使 うことができます 表 9 DataSource オブジェクトの 実 装 クラス 名 接 続 プール 機 能 備 考 org.postgresql.ds.pgsimpledatasource なし org.postgresql.ds.pgpoolingdatasource あり 接 続 プロパティ オンライン マニュアルには 一 部 のプロパティのみが 記 載 されています DataSource オ ブジェクトに 対 しても DriverManager オブジェクトと 同 様 のプロパティを 指 定 することが できます プロパティ 名 を 羅 列 した URL は seturl メソッドで 指 定 することができます 基 本 的 に DriverManager オブジェクトで 指 定 する URL と DataSource オブジェクトで 指 定 する URL は 同 じですが いくつかのプロパティが 異 なります seturl メ ソ ッ ド は PostgreSQL 9.3 用 の JDBC Driver で あ る postgresql jdbc41.jar フ ァ イ ル で は エ ラ ー に な ら な か っ た 構 文 が postgresql jdbc41.jar ファイルでは java.lang.nullpointerexception 例 外 を 発 生 してエラーになる 場 合 があります このバグは 認 識 されており 更 新 版 がリリー スされる 予 定 です 接 続 プール 接 続 プール 機 能 を 持 った PGPoolingDataSource オブジェクトには DataSource オブジ ェ ク ト 名 を 指 定 す る setdatasourcename メ ソ ッ ド 初 期 接 続 数 を 指 定 す る setinitialconnections メソッドおよび 最 大 接 続 数 を 指 定 する setmaxconnections メソッド が 提 供 されています 22

23 プロパティ 初 期 値 initialconnections プロパティ maxconnections プロパティの 初 期 値 は 0 です 実 際 に は 初 期 セッションは 1 になり 上 限 は 無 制 限 (インスタンスの max_connections パラメー タに 依 存 )となります どちらのプロパティも 最 初 の getconnection メソッドが 実 行 され PostgreSQL インスタ ンスとの 接 続 が 発 生 した 後 では 変 更 できません 変 更 しようとすると 以 下 の 例 外 が 発 生 し ます 例 12 DataSource 使 用 後 にプロパティ 変 更 時 に 発 生 する 例 外 Exception in thread "main" java.lang.illegalstateexception: Cannot set Data Source properties after DataSource has been used at org.postgresql.ds.jdbc23.abstractjdbc23poolingdatasource.setmaxconnections(abs tractjdbc23poolingdatasource.java:222) 初 期 接 続 の 実 際 の 開 始 契 機 実 際 に PostgreSQL インスタンスとの 接 続 が 開 始 されるのは 最 初 に DataSource#getConnection メ ソ ッ ド が 発 生 し た 時 点 で す 最 初 の 接 続 時 に initialconnections プロパティで 指 定 された 数 のセッションが 作 成 されます 最 大 接 続 以 上 に Connection オブジェクトを 要 求 した 場 合 maxconnections プロパティで 指 定 した 数 まで getconnection メソッドを 実 行 すると 次 回 の getconnection メソッドは 使 用 中 の Connection オブジェクトがクローズされるま で 待 機 状 態 になります 最 大 接 続 以 上 の 初 期 接 続 maxconnections プロパティの 値 以 上 の initialconnections を 指 定 した 場 合 エラーは 発 生 せず initialconnections の 値 が 有 効 になります セッションをクローズした 場 合 取 得 した Connection オブジェクトをクローズ(close メソッド)しても 物 理 セッショ ンはクローズされません 23

24 2.2.4 ログの 出 力 PGPoolingDataSource クラス PGSimpleDataSource クラス 共 に loglevel プロパティが 用 意 されており Connection クラスと 同 様 のログ 設 定 を 行 うことができます ログの 出 力 先 は DataSource#setLogWriter メソッドに PrintWriter オブジェクトを 指 定 します 出 力 されるログは Connection オブジェクトのログと 同 等 です 以 下 は loglevel=2 を 指 定 した 場 合 のログ 出 力 例 です 例 13 DataSource#getConnection メソッド 実 行 時 のログ 08:36: (1) PostgreSQL 9.4 JDBC4.1 (build 1200) 08:36: (1) Trying to establish a protocol version 3 connection to localhost: :36: (1) Receive Buffer Size is :36: (1) Send Buffer Size is :36: (1) FE=> StartupPacket(user=demo, database=demodb, client_encoding=utf8, DateStyle=ISO, TimeZone=Asia/Tokyo, extra_float_digits=2) 08:36: (1) <=BE AuthenticationOk 08:36: (1) <=BE ParameterStatus(application_name = ) 08:36: (1) <=BE ParameterStatus(client_encoding = UTF8) << 途 中 省 略 >> 08:36: (1) <=BE ReadyForQuery(I) 08:36: (1) compatible = :36: (1) loglevel = 2 08:36: (1) prepare threshold = 5 08:36: (1) types using binary send = INT8_ARRAY,TIMESTAMPTZ,FLOAT4_ARRAY,FLOAT8_ARRAY,UUID,TEXT_ARRAY,VARCHAR_ARRAY,BYTEA,TIME,FLOAT4,FLOAT8,INT2_ARRAY,TIMETZ,INT2,INT8,INT4,INT4_ARRAY,TIMESTAM P,POINT,BOX 08:36: (1) types using binary receive = INT8_ARRAY,TIMESTAMPTZ,FLOAT4_ARRAY,FLOAT8_ARRAY,UUID,TEXT_ARRAY,VARCHAR_ARRAY,BYTEA,TIME,DATE,FLOAT4,FLOAT8,INT2_ARRAY,TIMETZ,INT2,INT8,INT4,INT4_ARRAY,TIM ESTAMP,POINT,BOX 08:36: (1) integer date/time = true getconnection returning org.postgresql.driver 24

25 例 14 Connection#executeQuery メソッドに SELECT 文 指 定 時 のログ 08:36: (1) simple execute, 1e300, maxrows=0, fetchsize=0, flags=17 08:36: (1) FE=> Parse(stmt=null,query="SELECT COUNT(*) FROM bind1 WHERE c2=$1",oids={1043}) 08:36: (1) FE=> Bind(stmt=null,portal=null,$1=<'maj'>) 08:36: (1) FE=> Describe(portal=null) 08:36: (1) FE=> Execute(portal=null,limit=0) 08:36: (1) FE=> Sync 08:36: (1) <=BE ParseComplete [null] 08:36: (1) <=BE BindComplete [null] 08:36: (1) <=BE RowDescription(1) 08:36: (1) Field(,INT8,8,T) 08:36: (1) <=BE DataRow(len=5) 08:36: (1) <=BE CommandStatus(SELECT 1) 08:36: (1) <=BE ReadyForQuery(I) 2.3 ロードバランス 機 能 PostgreSQL JDBC Driver 9.4 には 接 続 時 に 複 数 のインスタンスを 選 択 するロードバラ ンス 機 能 が 提 供 されました 以 下 のプロパティを 使 用 できます 複 数 ホストの 指 定 従 来 のバージョンでは 接 続 先 インスタンスは url パラメータにホスト 名 とポート 番 号 を 一 つだけ 指 定 していました PostgreSQL JDBC Driver 9.4 では 複 数 のインスタンスを 指 定 することができるようになりました 従 来 と 同 じ 部 分 に 複 数 のホストとポート 番 号 をカン マ(,)で 区 切 って 指 定 します 例 15 複 数 インスタンスの URL 指 定 形 式 jdbc:postgresql://host1:5432, host2:5432/demodb DriverManager#connect メソッドによる 接 続 を 行 うと 標 準 状 態 では 先 頭 に 指 定 され たインスタンスから 順 番 に 接 続 を 試 行 します すべてのホストの 接 続 が 失 敗 した 場 合 には 25

26 例 外 が 発 生 します loadbalancehosts プロパティ インスタンスに 接 続 する 際 には インスタンスを url パラメータに 記 述 した 順 で 接 続 しま す loadbalancehosts パラメータを true に 設 定 すると 接 続 先 インスタンスをランダムに 選 択 することができます(デフォルト 値 は false) true または false 以 外 の 値 を 指 定 しても エラーにはなりません 従 来 このような 機 能 を 実 現 するには pgpool-ii が 必 要 でしたが SELECT 文 のみの 場 合 には JDBC Driver の 機 能 だけで 負 荷 分 散 を 実 現 することができるようになります ただ し 更 新 SQL の 場 合 に 自 動 的 にマスター インスタンスを 使 用 することは 行 わないため 更 新 処 理 を 含 むアプリケーションでは pgpool-ii の 方 が 高 機 能 になります targetservertype プロパティ 接 続 先 インスタンスの 種 類 を 指 定 するパラメータが targetservertype です 以 下 の 値 を 使 用 す る こ と が で き ま す 下 記 の 表 以 外 の 値 を 指 定 す る と org.postgresql.util.psqlexception 例 外 が 発 生 します 接 続 先 インスタンスの 種 類 の 選 択 は 接 続 先 インスタンスで 実 行 される SHOW TRANSACTION_READ_ONLY 文 から 判 断 しています 実 行 結 果 が ON (TRUE) の 場 合 スレーブ インスタンスとみなします 表 10 targetservertype プロパティの 選 択 肢 設 定 値 説 明 備 考 any すべての 種 類 のインスタンスに 接 続 デフォルト 値 master レプリケーション 環 境 のマスター インスタンス にのみ 接 続 します マスター インスタンスが 存 在 しない 場 合 は 例 外 が 発 生 します slave レプリケーション 環 境 のスレーブ インスタンス にのみ 接 続 します スレーブ インスタンスが 存 在 しない 場 合 には 例 外 が 発 生 します preferslave レプリケーション 環 境 のスレーブ インスタンス に 接 続 します スレーブ インスタンスが 存 在 し ない 場 合 にはマスター インスタンスに 接 続 しま す 26

27 2.3.4 hostrecheckseconds プロパティ インスタンスの 稼 働 状 態 をキャッシュする 秒 数 を 指 定 します デフォルト 値 は 10 秒 です プロパティに 数 値 以 外 の 値 を 指 定 した 場 合 org.postgresql.util.psqlexception 例 外 が 発 生 します 2.4 ResultSet の 列 名 ResultSet オブジェクトからデータを 取 得 する get<データ 型 > メソッドには 列 番 号 を 指 定 するメソッドと 列 名 を 文 字 列 として 指 定 するメソッドが 定 義 されています 以 下 の 例 では getstring メソッドに 列 名 を 指 定 しています 例 16 ResultSet オブジェクトから 列 名 を 指 定 したデータ 取 得 String sql = "SELECT column1, column2 FROM table1" ; ResultSet rs = statement.executequery(sql) ; String result = rs.getstring("column1") ; PostgreSQL の JDBC Driver は 関 数 を 指 定 した 場 合 や 列 の 別 名 を 指 定 した 場 合 SELECT で 指 定 した 列 名 と get<データ 型 > で 指 定 する 列 名 が 異 なる 場 合 があります 下 記 のように JDBC メソッドで 指 定 する 列 名 は SELECT 文 で 指 定 された 別 名 または 列 名 を 小 文 字 化 した 値 です ダブル クオーテーション( )で 囲 んだ 場 合 はそのまま 使 用 できます また 列 に 対 して 関 数 を 使 った 場 合 メソッドに 指 定 する 列 名 は 関 数 名 のみにな ります 表 11 ResultSet オブジェクトの 列 名 SELECT 文 の 列 名 JDBC メソッド 列 名 変 更 される 点 COLUMN1 column1 小 文 字 化 Column2 column2 小 文 字 化 SUM(*) sum 小 文 字 化 /パラメータ 削 除 trim(column4) COL4 col4 別 名 を 小 文 字 化 trim(column5) AS COL5 col5 別 名 を 小 文 字 化 COUNT(*) AS col6 col6 別 名 を 小 文 字 化 column7 AS COL7 COL7 別 名 をそのまま 複 数 列 に 同 じ 関 数 名 を 指 定 した 場 合 最 初 の 関 数 名 が 指 定 した 列 の 値 が 帰 ります 下 記 の 例 では result 変 数 には TRIM(column1) 列 の 値 が 返 ります 27

28 例 17 関 数 を 指 定 した 列 からのデータ 取 得 String sql = "SELECT TRIM(column1), TRIM(column2) FROM table1" ; ResultSet rs = statement.executequery(sql) ; String result = rs.getstring("trim") ; 2.5 Fetch Size の 設 定 Statement オブジェクトの setfetchsize メソッドは SELECT 文 を 実 行 した 場 合 のキャ ッシュ レコード 数 を 取 得 します メモリー 使 用 Statement オブジェクトの setfetchsize メソッドは SELECT 文 を 実 行 した 場 合 のキャ ッシュ レコード 数 を 設 定 します この 設 定 は 自 動 コミット 設 定 がオフの 場 合 にのみ 有 効 になります(Connection#setAutoCommit(false)を 実 行 ) デフォルト 値 は 0 で 全 レコー ドがキャッシュ 対 象 になります このため デフォルト 状 態 では 検 索 結 果 の 全 レコードを Java VM ヒープ メモリーに 展 開 してから ResultSet#next メソッドが 実 行 できるように なります 大 規 模 なデータを 検 索 する 環 境 では 検 索 のみの 場 合 でも 自 動 コミットをオフに 設 定 してメモリー 領 域 の 肥 大 化 を 防 ぐことを 検 討 します 実 行 計 画 の 変 化 Fetch Size を 指 定 し て SQL 文 を 実 行 すると 実 行 計 画 はパラメータ cursor_tuple_fraction で 指 定 した 割 合 に 応 じて 実 行 計 画 を 変 更 します(デフォルト 値 0.1) パラメータ 値 を 小 さくすると 先 頭 レコードの 取 得 が 高 速 になる 実 行 計 画 が 選 択 されます (Nested Loop 結 合 等 ) 値 を 大 きくするとレコード 全 体 の 取 得 時 間 を 短 くする 実 行 計 画 が 選 択 されます(Hash Join 等 ) パラメータを 上 限 である 1.0 に 指 定 すると 全 レコードを 意 味 します 下 限 の 0 に 指 定 す ると 実 際 には (1-e10)が 使 用 されます 28

29 2.6 未 実 装 の 機 能 以 下 の メ ソ ッ ド は 実 装 さ れ て い ま せ ん 該 当 メ ソ ッ ド を 実 行 す る と org.postgresql.driver.notimplemented 例 外 が 発 生 します 下 記 表 の パラメータ 列 はメ ソッドのパラメータ 型 をカンマ(,)で 区 切 っています スラッシュ(/)はオーバーライド された 同 名 のメソッドのパラメータを 示 します 表 12 未 実 装 メソッド(Class: org.postgresql.driver) メソッド 名 パラメータ 備 考 getparentlogger - 表 13 未 実 装 メソッド(Class: org.postgresql.core.v2.queryexecutorimpl.java) メソッド 名 パラメータ 備 考 fetch ResultCursor, ResultHandler, int 表 14 未 実 装 メ ソ ッ ド ( Class: org.postgresql.ds.jdbc4.abstractjdbc4connectionpooldatasource) メソッド 名 パラメータ 備 考 getparentlogger - 表 15 未 実 装 メソッド(Class: org.postgresql.ds.jdbc4.abstractjdbc4pooledconnection) メソッド 名 パラメータ 備 考 getparentlogger - 表 16 未 実 装 メソッド(Class: org.postgresql.ds.jdbc4.abstractjdbc4poolingdatasource) メソッド 名 パラメータ 備 考 getparentlogger - 表 17 未 実 装 メソッド(Class: org.postgresql.ds.jdbc4.abstractjdbc4simpledatasource) メソッド 名 パラメータ 備 考 getparentlogger - 表 18 未 実 装 メソッド(Class: org.postgresql.jdbc2.abstractjdbc2array) メソッド 名 パラメータ 備 考 getarrayimpl long, int, Map 条 件 あり 29

30 表 19 未 実 装 メソッド(Class: org.postgresql.jdbc2.abstractjdbc2clob) メソッド 名 パラメータ 備 考 position String, long / Clob, long 表 20 未 実 装 メソッド(Class: org.postgresql.jdbc2.abstractjdbc2resultset) メソッド 名 パラメータ 備 考 geturl int / String getobjectimpl int, java.util.map 条 件 あり getref int 表 21 未 実 装 メソッド(Class: org.postgresql.jdbc2.abstractjdbc2statement) メソッド 名 パラメータ 備 考 setref int, Ref getblob int getclob int getobjectimpl int, java.util.map 条 件 あり getref int registeroutparameter int, int, String 表 22 未 実 装 メソッド(Class: org.postgresql.jdbc3.abstractjdbc3clob) メソッド 名 パラメータ 備 考 setstring long, String / long, String, int, int setasciistream long setcharacterstream long 表 23 未 実 装 メソッド(Class: org.postgresql.jdbc3. AbstractJdbc3DatabaseMetaData) メソッド 名 パラメータ 備 考 getsupertypes String, String, String getsupertables String, String, String getattributes String, String, String, String 30

31 表 24 未 実 装 メソッド(Class: org.postgresql.jdbc3.abstractjdbc3resultset) メソッド 名 パラメータ 備 考 geturl int / String updateref int, java.sql.ref / String, java.sql.ref updateblob int, java.sql.blob / String, java.sql.blob updateclob int, java.sql.clob / String, java.sql.clob 表 25 未 実 装 メソッド(Class: org.postgresql.jdbc3. AbstractJdbc3Statement) メソッド 名 パラメータ 備 考 seturl int, java.net.url / String, java.net.url registeroutparameter String, int / String, int, int / String, int, String geturl int setnull String, int / String, int, String setboolean String, boolean setbyte String, byte setshort String, short setint String, int setlong String, long setfloat String, float setdouble String, double setbigdecimal String, BigDecimal setstring String, String setbytes String, byte[] setdate String, java.sql.date / String, java.sql.date, Calendar settime String, java.sql.time / String, java.sql.time, Calendar settimestamp String, java.sql.timestamp / String, java.sql.timestamp, Calendar setasciistream String, java.io.inputstream, int setbinarystream String, java.io.inputstream, int setobject String, Object, int, int / String, Object, int / String, Object setcharacterstream String, java.io.reader, int getstring String getboolean String getbyte String 31

32 表 25( 続 ) 未 実 装 メソッド(Class: org.postgresql.jdbc3. AbstractJdbc3Statement) メソッド 名 パラメータ 備 考 getshort String getint String getlong String getfloat String getdouble String getbytes String getdate String / String, Calendar gettime String / String, Calendar gettimestamp String / String, Calendar getobject String getbigdecimal String getobjectimpl String, java.util.map getref String getblob String getclob String getarray String geturl String 表 26 未 実 装 メソッド(Class: org.postgresql.jdbc4.abstractjdbc4blob) メソッド 名 パラメータ 備 考 getbinarystream long, long 表 27 未 実 装 メソッド(Class: org.postgresql.jdbc4.abstractjdbc4clob) メソッド 名 パラメータ 備 考 getcharacterstream long, long 32

33 表 28 未 実 装 メソッド(Class: org.postgresql.jdbc4.abstractjdbc4connection) メソッド 名 パラメータ 備 考 createclob - createblob - createnclob - createstruct String, Object[] createqueryobject Class<T> setnetworktimeout Executor, int getnetworktimeout - 表 29 未 実 装 メソッド(Class: org.postgresql.jdbc4.abstractjdbc4databasemetadata) メソッド 名 パラメータ 備 考 getrowidlifetime - getfunctions String, String, String getfunctioncolumns String, String, String, String getpseudocolumns String, String, String, String 33

34 表 30 未 実 装 メソッド(Class: org.postgresql.jdbc4.abstractjdbc4resultset) メソッド 名 パラメータ 備 考 getrowid int updaterowid int, RowId getholdability - updatenstring int, String updatenclob int, NClob / int, Reader / int, Reader, long / String, NClob getnclob int / String updateblob int, InputStream, long / String, InputStream, long / int, InputStream / String, InputStream updateclob int, Reader, long / int, Reader / String, Reader, long / String, Reader getnstring int / String getncharacterstream int / String updatencharacterstream int, Reader, int / int, Reader / int, Reader, long / String, Reader, int / String, Reader / String, Reader, long updatecharacterstream int, Reader, long/ int, Reader / String, Reader, long / String, Reader updatebinarystream int, InputStream, long / int, InputStream / String, InputStream, long / String, InputStream updateasciistream int, InputStream, long / int, InputStream / String, InputStream, long / String, InputStream getobject int, Class<T> 34

35 表 31 未 実 装 メソッド(Class: org.postgresql.jdbc4.abstractjdbc4statement) メソッド 名 パラメータ 備 考 setrowid int, RowId / String, RowId setnstring int, String / String, String setncharacterstream int, Reader, long / int, Reader / String, Reader, long / String, Reader setcharacterstream int, Reader, long / int, Reader / String, Reader, long / String, Reader setasciistream int, InputStream, long / int, InputStream / String, InputStream, long / String, InputStream setnclob int, NCLob / int, Reader, long / int, Reader / String, NClob setclob int, Reader, long / int, Reader / String, Reader, long / String, Reader / String, Clob setblob int, InputStream, long / int, InputStream / String, InputStream, long / String, InputStream / String, Blob setnclob int, NClob, int, Reader, long / int, Reader / String, Reader, long / String, Reader getrowid int / String setbinarystream int, InputStream / String, InputStream long / String, InputStream getnclob int / String setsqlxml String, SQLXML getsqlxml String getnstring int / String getncharacterstream int / String getcharacterstream int / String getparentlogger - getobject int, Class<T> / String, Class<T> 表 32 未 実 装 メソッド(Class: org.postgresql.xa.jdbc4.abstractjdbc4xadatasource) メソッド 名 パラメータ 備 考 getparentlogger - 35

36 2.7 ドライバー 実 装 クラス Java 7 / Java 8 環 境 では JDBC Driver として postgresql jdbc41.jar ファイル を 使 います この JDBC ドライバーで 定 義 されている JDBC インターフェースは 実 際 には 以 下 のクラスを 使 用 します 表 33 主 なインターフェースとクラス インターフェース クラス 備 考 Blob org.postgresql.jdbc4.jdbc4blob Clob org.postgresql.jdbc4.jdbc4clob Connection org.postgresql.jdbc4.jdbc4connection DatabaseMetaData org.postgresql.jdbc4.jdbc4databasemetadata PreparedStatement org.postgresql.jdbc4.jdbc4preparedstatement ResultSet org.postgresql.jdbc4.jdbc4resultset ResultSetMetaData org.postgresql.jdbc4.jdbc4resultsetmetadata Statement org.postgresql.jdbc4.jdbc4statement SQLXML org.postgresql.jdbc4.jdbc4sqlxml 最 新 の JDBC インターフェースを 実 装 した 各 クラスは 古 い Java バージョンのクラスを 継 承 することで 実 装 されています 例 えば java.sql.connection インターフェースを 実 装 し た org.postgresql.jdbc4. Jdbc4Connection クラスの 継 承 関 係 は 以 下 のようになっています 表 34 Connection インターフェースの 基 底 クラスと 継 承 クラス 継 承 関 係 クラス 備 考 基 底 org.postgresql.pgconnection org.postgresql.core.baseconnection implements org.postgresql.jdbc2.abstractjdbc2connection org.postgresql.jdbc3g.abstractjdbc3gconnection org.postgresql.jdbc4.abstractjdbc4connection 継 承 org.postgresql.jdbc4.jdbc4connection 36

37 3. 追 加 モジュール 3.1 postgres_fdw postgres_fdw とは postgres_fdw は 外 部 システムに 対 して SQL 文 を 投 入 する FOREIGN DATA WRAPPER に 対 応 する contrib モジュール 5 で リモート ホストの PostgreSQL インスタンスに SQL 文 を 投 入 することができます 従 来 から PostgreSQL には ネットワーク 上 に 稼 働 する PostgreSQL インスタンスに SQL 文 を 投 入 する 機 能 として dblink 関 数 (contrib モジュー ル)が 提 供 されてきました しかしこの 関 数 は 扱 いにくいため より 簡 単 で 洗 練 された 実 装 として postgres_fdw モジュールが 開 発 されました PostgreSQL 9.3 からは FOREIGN DATA WRAPPER に 対 する 書 込 みを 行 うことが 可 能 になりました postgres_fdw の 使 用 方 法 postgres_fdw を 使 用 するためには 以 下 の 手 順 で 実 行 します CREATE EXTENSION 文 で postgres_fdw をロード CREATE SERVER 文 でリモート インスタンスを 特 定 CREATE USER MAPPING 文 でリモート アクセスするユーザーを 特 定 CREATE FOREIGN TABLE 文 でリモート テーブルを 特 定 ローカル テーブルと 同 様 に DML を 実 行 例 18 postgres_fdw の 使 用 方 法 postgres=# CREATE EXTENSION postgres_fdw ; CREATE EXTENSION postgres=# CREATE SERVER remsvr FOREIGN DATA WRAPPER postgres_fdw OPTIONS (host 'remhost1', dbname 'dbappl1', port '5432') ; CREATE SERVER postgres=# CREATE USER MAPPING FOR public SERVER remsvr OPTIONS (user 'postgres', password 'secret'); CREATE USER MAPPING postgres=# CREATE FOREIGN TABLE data1 (c1 NUMERIC, c2 VARCHAR(10)) SERVER remsvr; postgres=# SELECT * FROM data1 ; 5 マニュアルは 37

38 3.1.3 実 行 される SQL リモート インスタンスで SQL 文 が 投 入 されると postgres_fdw 経 由 でリモート イン スタンスに SQL 文 が 送 信 され 結 果 が 返 されます ここでは postgres_fdw が 送 信 する SQL 文 について 検 証 しています ユーザーが 投 入 した SQL 文 は 以 下 のように 変 更 されてリモー ト インスタンスに 送 信 されます 列 名 の * は 列 名 リストに 変 換 コメントは 削 除 予 約 語 は 大 文 字 に 変 換 集 計 (SUM, COUNT 等 )/グルーピング(GROUP BY)/ 順 番 (ORDER BY) /レコード 制 限 (LIMIT)は 削 除 結 合 は2つの SELECT 文 に 分 解 以 下 の 例 は リモート インスタンスに 対 して SELECT * FROM data1 文 を 投 入 した 場 合 に 実 行 される SQL 文 です 下 記 のように 複 数 の SQL 文 に 分 解 されて 実 行 されます SART TRANSACTION ISOLATION LEVEL REPEATABLE READ DECLARE CURSOR FETCH CLOSE COMMIT TRANSACTION 例 19 実 行 される SQL 文 の 例 START TRANSACTION ISOLATION LEVEL REPEATABLE READ DECLARE c1 CURSOR FOR SELECT c1, c2 FROM public.data1 FETCH 100 FROM c1 FETCH 100 FROM c1.. CLOSE c1 COMMIT TRANSACTION 次 の 表 は 投 入 した SQL 文 と 実 行 された SQL 文 の 対 比 です START TRANSACTION 文 FETCH 文 CLOSE 文 COMMIT 文 は 省 略 しています 38

39 表 35 ローカル 投 入 SQL とリモート 実 行 SQL( 検 索 ) ローカル 投 入 SQL リモート 実 行 SQL select * from data1 DECLARE c1 CURSOR FOR SELECT c1, c2 FROM public.data1 select c1 from data1 DECLARE c1 CURSOR FOR SELECT c1 FROM public.data1 select /* comment */ * from data1 DECLARE c1 CURSOR FOR SELECT c1, c2 FROM public.data1 select c1 from data1 order by 1 DECLARE c1 CURSOR FOR SELECT c1 FROM public.data1 select count(*) from data1 DECLARE c1 CURSOR FOR SELECT NULL FROM public.data1 select count(c1) from data1 DECLARE c1 CURSOR FOR SELECT c1 FROM public.data1 select c1 from data1 group by c1 DECLARE c1 CURSOR FOR SELECT c1 FROM public.data1 select * from data1 where c1 = 10 DECLARE c1 CURSOR FOR SELECT c1, c2 FROM public.data1 WHERE ((c1 < 10::numeric)) select * from data1 where octet_length(c2) = 2 DECLARE c1 CURSOR FOR SELECT c1, c2 FROM public.data1 WHERE ((octet_length(c2) = 2)) select d1.c1, d2.c2 from DECLARE c1 CURSOR FOR data1 d1, data2 d2 where d1.c1 = d2.c1 SELECT c1 FROM public.data1 WHERE ((c1 < 100::numeric)) DECLARE c2 CURSOR FOR SELECT c1, c2 FROM public.data2 WHERE ((c1 < 10::numeric)) SELECT 文 を 投 入 すると カーソルを 作 成 し 100 レコードずつフェッチを 行 っていま す フェッチ 数 の 100 はソースコード(contrib/postgres_fdw/postgres_fdw.c)にハードコ ードされているため 現 状 では 変 更 できません 次 の 例 は 更 新 文 で 実 行 される SQL 文 です UPDATE 文 DELETE 文 ではカーソルを 定 義 して 1レコードずつ UPDATE / DELETE 文 を 実 行 していることがわかります 39

40 表 36 ローカル 投 入 SQL とリモート 実 行 SQL( 更 新 ) ローカル 投 入 SQL リモート 実 行 SQL update data1 set c1 = c1 + 1 DECLARE c1 CURSOR FOR where c1 < 10 SELECT c1, c2, ctid FROM public.data1 WHERE ((c1 < 10::numeric)) FOR UPDATE FETCH 100 FROM c1 UPDATE public.data1 SET c1 = $2 WHERE ctid = $1 UPDATE public.data1 SET c1 = $2 WHERE ctid = $1 DEALLOCATE pgsql_fdw_prep_2 insert into data1 values INSERT INTO public.data1(c1, c2) VALUES ($1, $2) (20000, 'after') DEALLOCATE pgsql_fdw_prep_3 delete from data1 where c1 DECLARE c1 CURSOR FOR = SELECT ctid FROM public.data1 WHERE ((c1 = 20000::numeric)) FOR UPDATE FETCH 100 FROM c1 DELETE FROM public.data1 WHERE ctid = $1 DEALLOCATE pgsql_fdw_prep_ 接 続 時 に 使 用 される 情 報 postgres_fdw に よ る リ モ ー ト イ ン ス タ ン ス へ の 接 続 は libpq ラ イ ブ ラ リ の PQconnectdbParams 関 数 を 使 用 します 接 続 を 行 う 際 には CREATE SERVER 文 と CREATE USER MAPPING 文 で 指 定 されたリモート インスタンス 情 報 に 加 えて 以 下 の 情 報 を 追 加 して 接 続 されます 表 37 追 加 情 報 属 性 fallback_application_name client_encoding 設 定 値 postgres_fdw ローカル データベースのエンコーディング 名 40

41 3.2 pg_stat_statements pg_stat_statements の 概 要 pg_stat_statements モジュールは PostgreSQL インスタンス 上 で 実 行 された SQL 文 およ び 実 行 統 計 情 報 を 蓄 積 し データベース 管 理 者 に 公 開 する contrib モジュールです パフォ ーマンス チューニング 対 象 となる SQL 文 を 特 定 したい 場 合 に 有 効 です マニュアルは 以 下 の URL を 参 照 してください インストール 方 法 パラメータ shared_preload_libraries に pg_stat_statements を 登 録 し 監 視 対 象 データ ベースに 対 して CREATE EXTENSION pg_stat_statements 文 を 実 行 します 独 自 パラメータ pg_stat_statements モジュールは 以 下 の 独 自 パラメータを 持 ちます パラメータに 使 用 できる 値 はマニュアルの 通 りです 下 記 表 のコメント 欄 は pg_settings カタログの short_desc 列 の 内 容 です 表 38 独 自 パラメータの 説 明 パラメータ 説 明 pg_stat_statements.max Sets the maximum number of statements tracked by pg_stat_statements. pg_stat_statements.track Selects which statements are tracked by pg_stat_statements. pg_stat_statements.track_utility Selects whether utility commands are tracked by pg_stat_statements. pg_stat_statements.save Save pg_stat_statements statistics across server shutdowns. 作 成 されるオブジェクトとメモリー CREATE EXTENSION 文 を 実 行 すると 以 下 のオブジェクトが 作 成 されます 41

42 表 39 作 成 されるオブジェクト 種 類 オブジェクト 名 説 明 FUNCTION pg_stat_statements 統 計 データの 参 照 FUNCTION pg_stat_statements_reset 統 計 データのリセット VIEW pg_stat_statements pg_stat_statements(true) 関 数 を 実 行 するビ ュー インストールが 完 了 すると 共 有 メモリー 上 に 小 さな 領 域 (struct pgsssharedstate のサ イズ)を 追 加 確 保 します pg_stat_statements の 仕 様 pg_stat_statements モジュールが 使 用 するデータと 制 限 について 調 査 しました 入 出 力 ファイル pg_stat_statements モジュールにより 収 集 されたデータはpg_stat_statementsビューで 参 照 できますが このビューの 実 体 は{PGDATA}/pg_stat_tmp/pgss_query_texts.stat ファ イルです このファイルが 保 存 されるディレクトリは パラメータ stats_temp_directory には 依 存 しません パラメータ pg_stat_statements.save パラメータが on の 場 合 pgss_query_texts.stat フ ァイルは インスタンス 停 止 時 に{PGDATA}/pg_stat/pg_stat_statements.stat ファイルに 内 容 がコピーされます コピーが 完 了 すると 元 ファイル pgss_query_texts.stat ファイルは 削 除 されます インスタンス 起 動 時 に pg_stat_statements.stat ファイルが 存 在 するとファ イルを 読 み 込 み {PGDATA}/pg_stat_tmp/pgss_query_texts.stat ファイルに 展 開 されます 元 のファイルは 削 除 されます 同 一 と 見 なされる SQL 実 行 された SQL 文 には ID が 付 与 されます(queryid 列 ) この ID が 同 一 の SQL は 同 一 と 見 なされて pg_stat_statements ビュー 内 では 単 一 レコードになります 下 記 のように 一 部 のみ 異 なる SQL は 単 一 SQL と 見 なされます リテラルのみ 異 なる SQL リテラル 部 分 はクエスチョン マーク(?)に 変 換 され て query 列 に 格 納 されます SQL 文 の 大 文 字 / 小 文 字 が 異 なる SQL(SELECT と select 等 ) 単 語 間 のスペースの 個 数 が 異 なる SQL コメント 部 分 が 異 なる SQL 文 内 に 改 行 コードが 含 まれる SQL 微 妙 に 構 文 が 異 なるが 同 一 と 見 なされた SQL 文 の query 列 には 最 初 に 実 行 された SQL 42

43 文 が 格 納 されます 制 限 永 続 データである pg_stat_statements.stat ファイルに 対 する 書 込 みはインスタンス 停 止 時 (smart モード fast モード immediate モード 共 通 )に 行 われます このため OS の クラッシュや postmaster プロセスの 異 常 終 了 等 インスタンス 停 止 処 理 が 正 常 に 行 えない 場 合 SQL 実 行 統 計 情 報 は 失 われます pg_stat_statements ビュー pg_stat_statements ビューは 以 下 の 列 から 構 成 されます 表 40 pg_stat_statements ビューの 列 情 報 列 名 データ 型 説 明 備 考 userid oid SQL 文 を 実 行 したユーザーの OID dbid oid SQL 文 が 実 行 されたデータベースの OID queryid bigint SQL 文 の 内 部 ハッシュ 番 号 9.4~ query text SQL 文 の 文 字 列 先 頭 部 分 calls bigint SQL 文 実 行 回 数 total_time double 処 理 時 間 の 累 計 (ミリ 秒 ) rows bigint 取 得 または 更 新 レコード 数 累 計 shared_blks_hit bigint 共 有 バッファ キャッシュにヒットしたブ ロック 数 shared_blks_read bigint 共 有 バッファに 読 み 込 まれたブロック 数 shared_blks_dirtied bigint 共 有 バッファでダーティ 状 態 になったブロ ック 数 shared_blks_written bigint 共 有 バッファから 書 き 込 まれたブロック 数 local_blks_hit bigint ローカル キャッシュ ヒットしたブロッ ク 数 local_blks_read bigint 読 み 込 まれたローカル ブロック 数 local_blks_dirtied bigint ダーティ 状 態 になったブロック 数 local_blks_written bigint 書 き 込 まれたローカル ブロック 数 temp_blks_read bigint 読 み 込 まれた 一 時 ブロック 数 temp_blks_written bigint 書 き 込 まれた 一 時 ブロック 数 blk_read_time double ブロック 読 み 取 り 時 間 (ミリ 秒 ) blk_write_time double ブロック 書 き 込 み 時 間 (ミリ 秒 ) 43

44 検 索 の 例 以 下 の 例 では pg_stat_statements ビューを 検 索 しています 実 際 には WHERE 句 には リテラル 値 を 指 定 して 実 行 していますが query 列 にはバインド 変 数 化 された SQL 文 が 格 納 されていることがわかります 例 20 EXECUTE 文 実 行 時 のログ postgres=> SELECT query, calls, total_time, rows FROM pg_stat_statements WHERE query LIKE '%bind1%' ; query calls total_time rows select count(*) from bind1 where c2=?; select count(*) from bind1 where c1 between? and?; (2 rows) 44

45 3.3 auto_explain auto_explain の 概 要 auto_explain モジュールは PostgreSQL インスタンス 上 で 実 行 された SQL 文 の 実 行 計 画 を 自 動 的 にログに 出 力 する contrib モジュールです パフォーマンスが 悪 い SQL 文 の 特 定 と 実 行 計 画 の 確 認 の 両 方 を 一 度 に 実 施 できるモジュールになります マニュアルは 以 下 の URL を 参 照 してください インストール 方 法 パラメータ shared_preload_libraries に auto_explain を 登 録 します 独 自 パラメータ auto_explain モジュールは 以 下 の 独 自 パラメータを 持 ちます パラメータに 使 用 できる 値 はマニュアルの 通 りです 下 記 表 のコメント 欄 は pg_settings カタログの short_desc 列 の 内 容 です 表 41 独 自 パラメータの 説 明 パラメータ 説 明 (extra_desc 列 ) auto_explain.log_min_duration Sets the minimum execution time above which plans will be logged. auto_explain.log_analyze Use EXPLAIN ANALYZE for plan logging. auto_explain.log_verbose Use EXPLAIN VERBOSE for plan logging. auto_explain.log_buffers Log buffers usage. auto_explain.log_triggers Include trigger statistics in plans.(this has no effect unless log_analyze is also set.) auto_explain.log_format EXPLAIN format to be used for plan logging. auto_explain.log_nested_statements Log nested statements. auto_explain.log_timing Collect timing data, not just row counts auto_explain の 仕 様 auto_explain モジュールの 仕 様 について 調 査 しました 45

46 パラメータの 初 期 値 auto_explain.log_min_duration パラメータには 実 行 計 画 をログに 出 力 する SQL 文 の 最 少 時 間 を 指 定 します デフォルト 値 は-1 です マニュアルには-1 を 指 定 すると 無 効 とされて いますが 実 際 には 0 未 満 の 値 はすべて 無 効 と 見 なされます ログ 出 力 される SQL 文 実 行 計 画 に 関 係 が 無 いトランザクション 制 御 文 (BEGIN COMMIT ROLLBACK)や PREPARE 文 はログに 出 力 されません また 構 文 に 問 題 が 無 く 実 行 計 画 が 作 成 できた SQL でも 主 キー 違 反 等 の 理 由 によりエラーになった SQL 文 の 実 行 計 画 も 出 力 されません PREPARE 文 で 作 成 された SQL 文 を EXECUTE 文 で 実 行 する 場 合 には ログファイル には PREPARE 文 が 出 力 されます 下 記 の 例 は EXECUTE pg1(10) 文 を 実 行 した 場 合 のロ グです 例 21 EXECUTE 文 実 行 時 のログ LOG: duration: ms plan: Query Text: PREPARE pg1(integer) AS SELECT COUNT(*) FROM pgbench_accounts where aid=$1; Aggregate (cost= rows=1 width=0) -> Index Only Scan using pgbench_accounts_pkey on pgbench_accounts (cost= rows=1 width=0) Index Cond: (aid = 10) PL/pgSQL 内 の SQL 文 PL/pgSQL によるファンクション 内 から 発 行 された SQL 文 の 実 行 計 画 は 標 準 では 出 力 されません ファンクション 内 から 実 行 される SQL 文 の 実 行 計 画 を 出 力 するには パラメ ータ auto_explain.log_nested_statement を true に 設 定 する 必 要 があります(デフォルト 値 は false) 以 下 の 例 は 関 数 func1 内 で 実 行 された SELECT 文 の 実 行 計 画 を 出 力 したログ 出 力 です 46

47 例 22 PL/pgSQL 内 の SQL 文 ログ LOG: duration: ms plan: Query Text: SELECT COUNT(*) FROM bind1 WHERE c2=val Aggregate (cost= rows=1 width=0) -> Seq Scan on bind1 (cost= rows= width=0) Filter: ((c2)::text = 'maj'::text) CONTEXT: SQL statement "SELECT COUNT(*) FROM bind1 WHERE c2=val" PL/pgSQL function func1(character varying) line 5 at SQL statement LOG: duration: ms plan: Query Text: select func1('maj'); Result (cost= rows=1 width=0) 47

48 3.4 pg_hint_plan pg_hint_plan の 概 要 pg_hint_plan モジュールは PostgreSQL インスタンス 上 で 実 行 される SQL 文 の 実 行 計 画 を 固 定 するためのヒント 機 能 を 実 現 するモジュールです 通 常 は 統 計 情 報 から 自 動 的 に 決 定 される 実 行 計 画 に 影 響 を 与 えて 想 定 通 りの 実 行 計 画 に 変 更 することができます マニュアルは 以 下 の URL を 参 照 してください(2015 年 1 月 の 最 新 版 を 使 用 ) インストール 方 法 ソースからビルドする 場 合 には 上 記 URL から PostgreSQL のバージョンに 応 じたソー スコードをダウンロードします 例 23 pg_hint_plan のインストール $ make gcc -O2 -Wall -Wmissing-prototypes -Wpointer-arith -Wdeclaration-after-statement -Wendif-labels -Wmissing-format-attribute -Wformat-security -fno-strict-aliasing -fwrapv -fpic -I. -I./ -I/usr/local/pgsql/include/server -I/usr/local/pgsql/include/internal -D_GNU_SOURCE -c -o pg_hint_plan.o pg_hint_plan.c gcc -O2 -Wall -Wmissing-prototypes -Wpointer-arith -Wdeclaration-after-statement -Wendif-labels -Wmissing-format-attribute -Wformat-security -fno-strict-aliasing -fwrapv -fpic -L/usr/local/pgsql/lib -Wl,--as-needed -Wl,-rpath,'/usr/local/pgsql/lib',--enable-new-dtags -shared -o pg_hint_plan.so pg_hint_plan.o $ su Password: {PASSWORD} # make install /bin/mkdir -p '/usr/local/pgsql/share/extension' /bin/mkdir -p '/usr/local/pgsql/share/extension' /bin/mkdir -p '/usr/local/pgsql/lib' /usr/bin/install -c -m 644 pg_hint_plan.control '/usr/local/pgsql/share/extension/' /usr/bin/install -c -m 644 pg_hint_plan sql pg_hint_plan sql '/usr/local/pgsql/share/extension/' /usr/bin/install -c -m 755 pg_hint_plan.so '/usr/local/pgsql/lib/' 48

49 インストール 先 ディレクトリ 等 は pg_config コマンドから 自 動 的 に 判 断 されます パラメータ shared_preload_libraries に pg_hint_plan を 登 録 し 監 視 対 象 データベース に 対 して CREATE EXTENSION pg_hint_plan 文 を 実 行 します 作 成 されるオブジェクトとメモリー CREATE EXTENSION 文 を 実 行 すると 以 下 のオブジェクトが 作 成 されます 表 42 作 成 されるオブジェクト 種 類 オブジェクト 名 説 明 SCHEMA pg_hint_plan オブジェクト 格 納 用 スキーマ TABLE pg_hint_plan.hints ヒント 保 存 テーブル UNIQUE INDEX hints_norm_and_app hints テーブルに 対 する 一 意 索 引 独 自 パラメータ pg_hint_plan モジュールは 以 下 の 独 自 パラメータを 持 ちます パラメータに 使 用 できる 値 はマニュアルの 通 りです 下 記 表 のコメント 欄 は pg_settings カタログの short_desc 列 の 内 容 です 表 43 独 自 パラメータの 説 明 パラメータ pg_hint_plan.enable_hint pg_hint_plan.debug_print pg_hint_plan.parse_messages pg_hint_plan.message_level pg_hint_plan.enable_hint_table 説 明 Force planner to use plans specified in the hint comment preceding to the query. Logs results of hint parsing. Message level of parse errors. Message level of debug messages. Force planner to not get hint by using table lookups. 使 用 できるヒント 以 下 のヒントが 使 用 できます 構 文 はオンライン マニュアル ( 参 照 してください 49

50 表 44 使 用 できるヒント ヒント SeqScan / NoSeqScan IndexScan / NoIndexScan IndexScanRegexp BitmapScan / NoBitmapScan BitmapScanRegexp TidScan / NoTidScan IndexOnlyScan / NoIndexOnlyScan IndexOnlyScanRegexp NestLoop / NoNestLoop MergeJoin / NoMergeJoin HashJoin / NoHashJoin Leading Set Rows 説 明 シーケンシャル スキャンを 実 施 する / しない インデックス スキャンを 実 施 する / しない 正 規 表 現 を 使 ったインデックス スキャンを 実 施 する ビットマップ スキャンを 実 施 する 正 規 表 現 を 使 ったビットマップ スキャンを 実 施 する TID スキャンを 実 施 する / しない インデックス オンリー スキャンを 実 施 する / しない 正 規 表 現 を 使 ったインデックス オンリー スキャンを 実 施 する ネステッド ループ 結 合 を 実 施 する / しない マージ 結 合 を 実 施 する / しない ハッシュ 結 合 を 実 施 する / しない テーブルの 結 合 順 序 を 指 定 する パラメータの 設 定 処 理 レコード 数 の 設 定 ヒント 記 述 時 の 注 意 点 ここではマニュアルに 記 載 が 無 い 動 作 について 説 明 しています ヒント 構 文 のスペースと 括 弧 ヒント 名 と 括 弧 の 間 には 半 角 スペースを 含 めることができます({SPACE}, {TAB}はそれぞ れスペース タブの 入 力 を 示 します) 全 角 スペースはヒントの 構 文 エラーになります 例 24 ヒント 名 と 括 弧 の 間 のスペース /*+ SeqScan{SPACE}(demo1) */ /*+ IndexScan{TAB}(demo1 idx1_demo1) */ ヒントの 大 文 字 / 小 文 字 の 区 別 ヒント 名 は 大 文 字 / 小 文 字 を 区 別 しません 下 記 のヒントは 同 一 と 見 なされます 50

51 例 25 ヒント 名 の 大 文 字 / 小 文 字 /*+ SeqScan(demo1) */ /*+ seqscan(demo1) */ オブジェクト 名 の 大 文 字 / 小 文 字 の 区 別 オブジェクト 名 は 大 文 字 / 小 文 字 を 区 別 します 以 下 のヒント 記 述 は 無 効 です 例 26 オブジェクト 名 の 大 文 字 / 小 文 字 区 別 /*+ SeqScan(DEMO1) */ SELECT * FROM demo1 WHERE c1 = 1000 テーブルに 別 名 がある 場 合 実 体 名 を 使 えるか テーブルに 別 名 を 指 定 した 場 合 ヒントにも 別 名 を 指 定 する 必 要 があります 以 下 のヒ ントは 無 効 です SeqScan(d1) と 指 定 すると 有 効 になります 例 27 別 名 とヒントの 指 定 /*+ SeqScan(demo1) */ SELECT * FROM demo1 d1 WHERE c1 = 1000 オブジェクト 名 にスキーマ 名 を 修 飾 する 必 要 があるか SQL 文 内 のテーブル 名 にスキーマ 名 を 修 飾 している 場 合 でもヒントにはスキーマ 名 を 指 定 しません 異 なるスキーマ 内 の 同 一 テーブルを 結 合 する 場 合 には 別 名 を 付 けて 区 別 しま す 下 記 のヒントは 無 効 になります SeqScan(demo1)と 指 定 すると 有 効 になります 例 28 スキーマとヒントの 指 定 /*+ SeqScan(schema1.demo1) */ SELECT * FROM schema1.demo1 WHERE c1 = 1000 矛 盾 するヒントを 記 述 した 場 合 SeqScan と NoSeqScan 等 矛 盾 するヒントを 記 述 した 場 合 後 から 記 述 したヒントが 有 効 になります ログには 使 用 されなかったヒントは duplicate hint 項 目 に 出 力 されます コメントの 記 述 ヒントとして 有 効 なコメント 形 式 は /*+ コメント */ のみです --+ コメント 形 式 では 使 用 できません 51