[Database] Better support for Timestamp with Zone in the latest Oracle Spatial and Graph Property Graph Patch

原文はこちら。
https://blogs.oracle.com/oraclespatial/better-support-for-timestamp-with-zone-in-the-latest-oracle-spatial-and-graph-property-graph-patch

---

Oracle Spatial and Graph Property Graph機能のパッチがリリースされました。これには、PGX 3.1と最新のData Access Layerが含まれています。1つの重要な修正は、タイムゾーン付きタイムスタンプのサポートが向上したことです。

以下は改善点を説明する簡単な例です。

cfg = GraphConfigBuilder.forPropertyGraphRdbms()                         .setJdbcUrl("jdbc:oracle:thin:@127.0.0.1:1521:orcl122")                         .setUsername("pg")                         .setPassword("<YOUR_PASSWORD>")                         .setName("test_graph")                         .setMaxNumConnections(2)                         .setLoadEdgeLabel(false)                         .addVertexProperty("ts", PropertyType.TIMESTAMP_WITH_TIMEZONE, null)                         .addVertexProperty("name", PropertyType.STRING, "default_name")                         .addEdgeProperty("cost", PropertyType.DOUBLE, "1000000")                         .build();   opg = OraclePropertyGraph.getInstance(cfg);   v=opg.addVertex(10000l); v.setProperty("ts", new Date(1000l));   opg.commit()   v=opg.getVertex(10000l); ==>Vertex ID 10000 [vertex] {ts:dat:1969-12-31 16:00:01.0}

上記のgetVertexはjava.util.Date型のプロパティを返します（java.sql.Timestampはjava.util.Dateのサブクラス）。では、このグラフをリモートのPGXエンドポイントに読み込みましょう。

pgxSession=Pgx.getInstance("http://127.0.0.1:7007").createSession("session1"); analyst=pgxSession.createAnalyst(); pgxGraph = pgxSession.readGraphWithProperties(opg.getConfig(), true);

OSG PGの旧バージョンでは、以下の例外が発生する場合があります。

"java.lang.UnsupportedOperationException: loading type time_with_timezone through DAL not yet supported"

このパッチを適用すると、もWith this new patch, the above will go through without a problem. To sanity check, run a simple PGQL query and print the type of the timestamp property ts.

pgxResultSet = pgxGraph.queryPgql("SELECT n.ts MATCH (n)") elem=pgxResultSet.getResults() e1=elem.iterator().next() twz=e1.getTimestampWithTimezone(0) ==>1969-12-31T16:00:01Z   twz.getClass().getName() ==>java.time.OffsetDateTime

References:

Patch 28577866: MISSING LATEST PGX 3.1.X FUNCTIONS IN ORACLE 12.2 AND 18.1 (28577866)
https://support.oracle.com/rs?type=patch&id=28577866