JDBC ドライバのサポート

インストールと構成

InterSystems JDBC ドライバは、標準の InterSystems IRIS インストール・パッケージに含まれています。追加のインストールや設定の手順は不要です。クライアントの要件および使用法については、"InterSystems ソフトウェアでの Java の使用法" の “クライアントとサーバ間の構成” を参照してください。

JDBC ドライバを使用して InterSystems IRIS とアプリケーション間の接続を作成する方法の詳細は、"Connecting Your Application to InterSystems IRISOpens in a new tab" を参照してください。

InterSystems IRIS がインストールされていないシステムで JDBC ドライバを使用する場合は、GitHub の InterSystems IRIS ドライバのページOpens in a new tabからドライバ・パッケージをダウンロードできます。

必須の java.sql インタフェース

以下のインタフェースは実装する必要があります。クラスによっては、データベースでサポートされない機能に実装が依存する場合はオプションになるメソッドが含まれているものがあります。標準の実装という注釈は、クラスの一般的な実装が変更なしに使用されていることを示します。

• java.sql.CallableStatement — 許可されるバリアントと共に実装されます (“CallableStatement ： サポートされないメソッド” および “CallableStatement getBinaryStream() 拡張メソッド” を参照)。

• java.sql.ClientInfoStatus — 標準の実装。

• java.sql.Connection — 許可されるバリアントと共に実装されます ("Connection ： サポートされないまたは制限のあるメソッド" を参照)。

• java.sql.DatabaseMetaData — 許可されるバリアントと共に実装されます (“DatabaseMetaData ： バリアント・メソッド” を参照)。

• java.sql.Date — 標準の実装。

• java.sql.Driver — 許可されるバリアントと共に実装されます (“Driver ： サポートされないメソッド” を参照)。

• java.sql.DriverManager — 標準の実装。

• java.sql.DriverPropertyInfo — 標準の実装。

• java.sql.ParameterMetaData — すべてのメソッドが完全にサポートされます。

• java.sql.PreparedStatement — 許可されるバリアントと共に実装されます (“PreparedStatement ： サポートされないメソッド” を参照)。

• java.sql.ResultSet — 許可されるバリアントと共に実装されます (“ResultSet ： サポートされないまたは制限のあるメソッド” を参照)。

• java.sql.ResultSetMetaData — すべてのメソッドが完全にサポートされます。

• java.sql.RowIdLifeTime — 標準の実装。

• java.sql.SQLPermission — 標準の実装。

• java.sql.Statement — 許可されるバリアントと共に実装されます (“Statement ： サポートされないまたは制限のあるメソッド” を参照)。

• java.sql.Time — 標準の実装。

• java.sql.Timestamp — 標準の実装。

• java.sql.Types — 標準の実装。

• java.sql.Wrapper — すべてのメソッドが完全にサポートされます。

オプションの java.sql インタフェース

オプションの java.sql インタフェースをすべて以下に示します。イタリック体になっている項目は実装されません。

• java.sql.Array

• java.sql.Blob — すべてのメソッドが完全にサポートされます。

• java.sql.Clob — すべてのメソッドが完全にサポートされます。

• java.sql.NClob — すべてのメソッドが完全にサポートされます。

• java.sql.Ref

• java.sql.RowId — すべてのメソッドが完全にサポートされます。

• java.sql.Savepoint — すべてのメソッドが完全にサポートされます。

• java.sql.SQLData

• java.sql.SQLInput

• java.sql.SQLOutput

• java.sql.SQLXML

• java.sql.Struct

java.sql の例外

InterSystems JDBC ドライバは、以下の例外のみをスローします。

• java.sql.BatchUpdateException

• java.sql.SQLException

• java.sql.SQLWarning

以下の例外は、完全を期すためにここにリストしていますが、必要ではなく、使用することはありません。

• DataTruncation

• SQLClientInfoException

• SQLDataException

• SQLFeatureNotSupportedException

• SQLIntegrityConstraintViolationException

• SQLInvalidAuthorizationSpecException

• SQLNonTransientConnectionException

• SQLNonTransientException

• SQLRecoverableException

• SQLSyntaxErrorException

• SQLTimeoutException

• SQLTransactionRollbackException

• SQLTransientConnectionException

• SQLTransientException

必須の javax.sql インタフェース

以下の必須インタフェースがサポートされています。標準の実装という注釈は、クラスの一般的な実装が変更なしに使用されていることを示します。

• javax.sql.ConnectionEvent — 標準の実装。

• javax.sql.DataSource — 拡張機能や追加メソッドと共に実装されます (詳細は “DataSource の拡張メソッドと拡張機能” を参照)。

• javax.sql.RowSetEvent — 標準の実装。

• javax.sql.StatementEvent — 標準の実装。

オプションの javax.sql インタフェース

オプションの javax.sql インタフェースをすべて以下に示します。イタリック体になっている項目は実装されません。

• javax.sql.CommonDataSource — 実装されません。代わりに javax.sql.DataSource を使用してください (関連情報は、“DataSource の拡張メソッドと拡張機能” を参照)。

• javax.sql.ConnectionEventListener — すべてのメソッドが完全にサポートされます。

• javax.sql.ConnectionPoolDataSource — バリアントや追加メソッドと共に実装されます (詳細は “ConnectionPoolDataSource の拡張メソッドと拡張機能” を参照)。

• javax.sql.PooledConnection — すべてのメソッドが完全にサポートされます。

• javax.sql.Rowset

• javax.sql.RowSetInternal

• javax.sql.RowSetListener

• javax.sql.RowSetMetaData

• javax.sql.RowSetReader

• javax.sql.RowSetWriter

• javax.sql.StatementEventListener

• javax.sql.XAConnection

• javax.sql.XADataSource

CallableStatement ： サポートされないメソッド

java.sql.CallableStatement は、以下のオプションのメソッドをサポートしません。

• getArray()

  Array getArray(int i)
  Array getArray(String parameterName)
  
  

  

• getObject()

  Object getObject(int i, java.util.Map map)
  Object getObject(String parameterName, java.util.Map map)
  

  

• getRef()

  Ref getRef(int i)
  Ref getRef(String parameterName)
  

  

• getRowId() および setRowId()

  java.sql.RowId getRowId(int i)
  java.sql.RowId getRowId(String parameterName)
  
  void setRowId(String parameterName, java.sql.RowId x)
  

  

• getURL() および setURL()

  java.net.URL getURL(int i)
  java.net.URL getURL(String parameterName)
  
  void setURL(String parameterName, java.net.URL val)
  

  

• getSQLXML() および setSQLXML()

  java.sql.SQLXML getSQLXML(int parameterIndex)
  java.sql.SQLXML getSQLXML(String parameterName)
  
  void setSQLXML(String parameterName, java.sql.SQLXML xmlObject)
  

  

Connection ： サポートされないまたは制限のあるメソッド

java.sql.Connection は、以下のオプションのメソッドをサポートしません。

• abort()

  void abort(Executor executor)
  

  

• createArrayOf()

  java.sql.Array createArrayOf(String typeName, Object[] elements)
  

  

• createBlob()

  Blob createBlob()
  

  

• createClob()

  Clob createClob()
  

  

• createNClob()

  java.sql.NClob createNClob()
  

  

• createSQLXML()

  java.sql.SQLXML createSQLXML()
  

  

• createStruct()

  java.sql.Struct createStruct(String typeName, Object[] attributes)
  

  

• getTypeMap()

  java.util.Map getTypeMap()
  

  

• setTypeMap()

  void setTypeMap(java.util.Map map)
  

  

以下のオプションの java.sql.Connection メソッドは、制限事項または制約付きで実装されています。

• prepareCall()

  TYPE_FORWARD_ONLY のみが resultSetType でサポートされます。CONCUR_READ_ONLY のみが resultSetConcurrency でサポートされます。

  java.sql.CallableStatement prepareCall(String sql, int resultSetType, int resultSetConcurrency)
  

  

• setReadOnly()

  空命令 (InterSystems IRIS ドライバは READ_ONLY モードをサポートしない)

  void setReadOnly(Boolean readOnly)
  

  

• setCatalog()

  空命令 (InterSystems IRIS ドライバはカタログをサポートしない)

  void setCatalog(String catalog)
  

  

• setTransactionIsolation()

  TRANSACTION_READ_COMMITED および TRANSACTION_READ_UNCOMMITED のみが level でサポートされます。

  void setTransactionIsolation(int level)
  

  

以下の java.sql.Connection メソッドは resultSetHoldability に対して CLOSE_CURSORS_AT_COMMIT をサポートしません。

• createStatement()

  java.sql.Statement createStatement(int resultSetType, int result, int resultSetHoldability)
  

  

• prepareCall()

  java.sql.CallableStatement prepareCall(String sql,
                                         int resultSetType,
                                         int resultSetConcurrency,
                                         int resultSetHoldability)
  

  

• prepareStatement()

  java.sql.PreparedStatement prepareStatement(String sql,
                                         int resultSetType,
                                         int resultSetConcurrency,
                                         int resultSetHoldability)
  

  

InterSystems IRIS では現在、0 個または 1 個の自動生成キーのみがサポートされています。以下の java.sql.Connection メソッドに、配列の長さが 1 以外の columnIndexes 配列または columnNames 配列を指定すると、例外がスローされます。

• prepareStatement()

  java.sql.PreparedStatement prepareStatement(String sql, int[] columnIndexes)
  java.sql.PreparedStatement prepareStatement(String sql, String[] columnNames)
  

  

DatabaseMetaData ： バリアント・メソッド

java.sql.DatabaseMetaData は完全にサポートされますが、戻り値の処理をインターシステムズ固有の方法で行うために JDBC 標準と異なるメソッドが含まれます。以下のメソッドが影響を受けます。

• supportsMixedCaseQuotedIdentifiers()

  InterSystems IRIS は false を返します。これは JDBC 準拠ではありません。

  boolean supportsMixedCaseQuotedIdentifiers()
  

  

• getIdentifierQuoteString()

  区切り識別子のサポートがオンの場合、InterSystems IRIS は " (二重引用符) を返します。これは、JDBC 準拠のドライバが返す値です。そうでない場合、InterSystems IRIS はスペースを返します。

  String getIdentifierQuoteString()
  

  

Driver ： サポートされないメソッド

java.sql.Driver は、以下のオプションのメソッドをサポートしません。

• getParentLogger()

  void getParentLogger()
  

  

PreparedStatement ： サポートされないメソッド

java.sql.PreparedStatement は、以下のオプションのメソッドをサポートしません。

• setArray()

  void setArray(int i, Array x)
  

  

• setRef()

  void setRef(int i, Ref x)
  

  

• setRowId()

  void setRowId(int parameterIndex, RowId x)
  

  

• setSQLXML()

  void setSQLXML(int parameterIndex, SQLXML xmlObject)
  

  

• setUnicodeStream()

  Java JDK 仕様で廃止されました。

  void setUnicodeStream(int i, InputStream x, int length)
  

  

• setURL()

  void setURL(int i, java.net.URL x)
  

  

ResultSet ： サポートされないまたは制限のあるメソッド

InterSystems IRIS は、TYPE_SCROLL_SENSITIVE 結果セット・タイプをサポートしません。以下のメソッドは、制限事項付きで実装されています。

• setFetchDirection()

  ResultSet.FETCH_REVERSE をサポートしません (代わりに、結果セットのカーソルを最後の行に移動する場合は afterLast を使用し、逆方向にスクロールする場合は previous を使用)。

  void setFetchDirection(int direction)
  

  

java.sql.ResultSet は、以下のオプションのメソッドをサポートしません。

• getArray()

  Array getArray(int i)
  Array getArray(String colName)
  

  

• getCursorName()

  String getCursorName()
  

  

• getObject()

  Object getObject(int i, java.util.Map map)
  Object getObject(String colName, java.util.Map map)
  

  

• getRef()

  Ref getRef(int i)
  Ref getRef(String colName)
  

  

• getHoldability()

  int getHoldability()
  

  

• getUnicodeStream()

  Java JDK 仕様で廃止されました。

  java.io.InputStream getUnicodeStream(int i)
  java.io.InputStream getUnicodeStream(String colName)
  

  

• getURL()

  java.net.URL getURL(int i)
  java.net.URL getURL(String colName)
  

  

• updateArray()

  void updateArray(int i, Array x)
  void updateArray(String colName, Array x)
  

  

• updateRef()

  void updateRef(int i, Ref x)
  void updateRef(String colName, Ref x)
  

  

Statement ： サポートされないまたは制限のあるメソッド

java.sql.Statement は、以下のオプションのメソッドをサポートしません。

• cancel()

  void cancel()
  

  

• closeOnCompletion()

  void closeOnCompletion()
  

  

• isCloseOnCompletion()

  boolean isCloseOnCompletion()
  

  

以下のオプションの java.sql.Statement メソッドは、制限事項または制約付きで実装されています。

• getResultSetHoldability()

  HOLD_CURSORS_OVER_COMMIT のみ

  int getResultSetHoldability()
  

  

• setCursorName()

  空命令

  void setCursorName(String name)
  

  

• setEscapeProcessing()

  空命令 (適用されない)

  void setEscapeProcessing(Boolean enable)
  

  

• setFetchDirection()

  ResultSet.FETCH_REVERSE をサポートしません (代わりに、結果セットのカーソルを最後の行に移動する場合は afterLast を使用し、逆方向にスクロールする場合は previous を使用)。

  void setFetchDirection(int direction)
  

  

InterSystems IRIS がサポートする自動生成キーは、現在 0 個または 1 個のみです。以下の java.sql.Statement メソッドが、配列の長さが 1 以外の columnIndexes 配列または columnNames 配列を指定すると、例外がスローされます。

• execute()

  boolean execute(String sql, int[] columnIndexes)
  boolean execute(String sql, String[] columnNames)
  

  

• executeUpdate()

  int executeUpdate(String sql, int[] columnIndexes)
  int executeUpdate(String sql, String[] columnNames)
  

  

CallableStatement getBinaryStream() 拡張メソッド

java.sql.CallableStatement は、以下のさらに別のインターシステムズ固有の拡張メソッドを実装します。

• getBinaryStream()

  指定されたパラメータの値を java.io.InputStream オブジェクトとして取得します (ここで、i はパラメータのインデックスです)。

  java.io.InputStream getBinaryStream(int i)
  

  

  このメソッドは、標準の setBinaryStream() メソッドを補完するもので、getCharacterStream() (java.io.Reader を返す) に代わるものです。

ConnectionPoolDataSource の拡張メソッドと拡張機能

com.intersystems.jdbc.IRISConnectionPoolDataSource クラスは、javax.sql.ConnectionPoolDataSource インタフェースを完全に実装します。このクラスは、InterSystems JDBC ドライバでサポートされていない javax.sql.CommonDataSource のメソッドを継承しません。

getPooledConnection() は、JDBC 標準で必要なため実装されますが、InterSystems IRIS 実装を直接呼び出すことはできません。InterSystems IRIS ドライバ接続の取得は常に getConnection() メソッドを呼び出すことによって行う必要があります (詳細は、"InterSystems ソフトウェアでの Java の使用法" の “接続プールの使用法” を参照してください)。

• getPooledConnection()

  javax.sql.PooledConnection getPooledConnection()
  javax.sql.PooledConnection getPooledConnection(String usr,String pwd)
  
  

  

IRISConnectionPoolDataSource は、さらに別のインターシステムズの拡張メソッドを提供する IRISDataSource (“DataSource の拡張メソッドと拡張機能” を参照) から継承します。

DataSource の拡張メソッドと拡張機能

com.intersystems.jdbc.IRISDataSource クラスは、javax.sql.DataSource インタフェースを完全に実装します。このクラスは、InterSystems JDBC ドライバでサポートされていない javax.sql.CommonDataSource のメソッドを継承しません。

このメソッドの InterSystems IRIS 実装は、自動の透過的な接続プーリングを提供するために拡張されます (詳細は、"InterSystems ソフトウェアでの Java の使用法" の “接続プールの使用法” を参照してください)。

• getConnection()

  java.sql.Connection getConnection()
  java.sql.Connection getConnection(String usr,String pwd)