dnrops
/
node-oracledb
mirror of https://github.com/oracle/node-oracledb
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Final commits for 6.6 release

This commit is contained in:
Sharad Chandran R 2024-07-25 12:16:41 +05:30
parent c63115f0cf
commit e1a3e09c67
6 changed files with 143 additions and 37 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
doc/src/conf.py
View File

@ -46,8 +46,8 @@ author = 'Oracle'
# from the other)
#
# The short X.Y version.
version = '6.5'
release = '6.5.1'
version = '6.6'
release = '6.6.0'
# There are two options for replacing |today|: either, you set today to some
# non-false value, then it is used:

19
doc/src/release_notes.rst
View File

@ -7,16 +7,18 @@ node-oracledb Release Notes
For deprecated and desupported features, see :ref:`Deprecations and desupported features <deprecations>`.
node-oracledb `v6.6.0 <https://github.com/oracle/node-oracledb/compare/v6.5.1...v6.6.0>`__ (TBD)
node-oracledb `v6.6.0 <https://github.com/oracle/node-oracledb/compare/v6.5.1...v6.6.0>`__ (25 Jul 2024)
---------------------------------------------------------------------------------------------------------
Common Changes
++++++++++++++
#) Added support for binary vector datatype (Oracle Database 23ai feature)
#) Added support for Oracle Database 23ai
:ref:`BINARY vector format <binaryvectors>`.
#) Added support for Centralized Configuration Providers (Azure App
Configuration Store and OCI Object Storage). Node-oracledb extracts
#) Added support for
:ref:`Centralized Configuration Providers <configurationprovider>` (Azure
App Configuration Store and OCI Object Storage). Node-oracledb extracts
configuration information from the supported provider and uses it to
connect to the database.
@ -27,9 +29,12 @@ Common Changes
Thin Mode Changes
+++++++++++++++++
#) Added support for in-memory wallet by adding a new parameter
``walletContent`` of type ``string`` that will allow users to pass the
wallet content directly instead of storing and reading it up from a file.
#) Added support for in-memory wallet by adding a new property
``walletContent`` to
:ref:`oracledb.createPool() <createpoolpoolattrswalletcontent>`
and :ref:`oracledb.getConnection() <getconnectiondbattrswalletcontent>`
that will allow users to pass the wallet content directly instead of
storing and reading it up from a file.
See `Issue #1671 <https://github.com/oracle/node-oracledb/issues/
1671>`__.

31
doc/src/user_guide/migrate.rst
View File

@ -4,6 +4,37 @@
Upgrading to the Latest node-oracledb Releases
**********************************************
.. _upgradev65v66:
Upgrading from node-oracledb 6.5 to 6.6
=======================================
- Review the :ref:`releasenotes` and take advantage of new features.
- With the new :ref:`BINARY <binaryvectors>` vector format, the value
of each vector dimension can be represented as a single bit (0 or 1).
- You can retrieve configuration information from two
:ref:`Centralized Configuration Providers <configurationprovider>`,
:ref:`Microsoft Azure App Configuration <azureappconfig>` and
:ref:`Oracle Cloud Infrastructure (OCI) Object Storage <ociobjstorage>`
and connect to Oracle Database.
- You can use the new :ref:`oracledb.DB_TYPE_BFILE <oracledbconstantsdbtype>`
constant to represent Oracle Database 23ai data type
:ref:`BFILE <insertbfile>`.
- In node-oracledb Thin mode, you can directly specify the security
credentials in the ``walletContent`` property of
:ref:`oracledb.createPool() <createpoolpoolattrswalletcontent>` and
:ref:`oracledb.getConnection() <getconnectiondbattrswalletcontent>`.
- The support for ``IFILE`` parameter of :ref:`tnsnames.ora <tnsadmin>` file
allows you to embed custom network configuration files in node-oracledb Thin
mode.
- You can now use :ref:`Two-Phase Commits <twopc>` in node-oracledb Thin mode.
.. _upgradev64v65:
Upgrading from node-oracledb 6.4 to 6.5

121
test/dataTypeVector1.js
View File

@ -39,10 +39,14 @@ const assist = require('./dataTypeAssist.js');
describe('294. dataTypeVector1.js', function() {
let connection = null, isRunnable = false, defaultFetchTypeHandler;
let isVectorBinaryRunnable = false;
before('Get connection', async function() {
isRunnable = await testsUtil.checkPrerequisites(2304000000, 2304000000);
if (!isRunnable) this.skip();
if (await testsUtil.isVectorBinaryRunnable()) {
isVectorBinaryRunnable = true;
}
defaultFetchTypeHandler = oracledb.fetchTypeHandler;
connection = await oracledb.getConnection(dbConfig);
@ -58,25 +62,43 @@ describe('294. dataTypeVector1.js', function() {
const tableName = 'nodb_vectorDbTable';
before('Create table', async function() {
const sql = `CREATE TABLE ${tableName} (
IntCol NUMBER(9) NOT NULL,
VectorCol VECTOR,
VectorFixedCol VECTOR(2),
Vector32Col VECTOR(10, float32),
Vector64Col VECTOR(10, float64),
VectorInt8Col VECTOR(4, int8),
VectorBinaryCol VECTOR(16, binary),
VectorFlexCol VECTOR(*, *),
VectorFlex32Col VECTOR(*, float32),
VectorFlex64Col VECTOR(*, float64),
VectorFlex8Col VECTOR(*, int8),
VectorFlexBinaryCol VECTOR(*, binary)
)`;
let sql;
if (isVectorBinaryRunnable) {
sql = `CREATE TABLE ${tableName} (
IntCol NUMBER(9) NOT NULL,
VectorCol VECTOR,
VectorFixedCol VECTOR(2),
Vector32Col VECTOR(10, float32),
Vector64Col VECTOR(10, float64),
VectorInt8Col VECTOR(4, int8),
VectorBinaryCol VECTOR(16, binary),
VectorFlexCol VECTOR(*, *),
VectorFlex32Col VECTOR(*, float32),
VectorFlex64Col VECTOR(*, float64),
VectorFlex8Col VECTOR(*, int8),
VectorFlexBinaryCol VECTOR(*, binary)
)`;
} else {
sql = `CREATE TABLE ${tableName} (
IntCol NUMBER(9) NOT NULL,
VectorCol VECTOR,
VectorFixedCol VECTOR(2),
Vector32Col VECTOR(10, float32),
Vector64Col VECTOR(10, float64),
VectorInt8Col VECTOR(4, int8),
VectorFlexCol VECTOR(*, *),
VectorFlex32Col VECTOR(*, float32),
VectorFlex64Col VECTOR(*, float64),
VectorFlex8Col VECTOR(*, int8)
)`;
}
const plsql = testsUtil.sqlCreateTable(tableName, sql);
await connection.execute(plsql);
});
after('Release connection', async function() {
isVectorBinaryRunnable = false;
await connection.execute(testsUtil.sqlDropTable(tableName));
});
@ -185,6 +207,8 @@ describe('294. dataTypeVector1.js', function() {
}); // 294.1.4
it('294.1.5 binding a binary vector type with various number typed arrays', async function() {
if (!isVectorBinaryRunnable) this.skip();
const uInt8Arr1 = new Uint8Array([3, 4]);
let binds = [
{ type: oracledb.DB_TYPE_VECTOR, val: uInt8Arr1 },
@ -210,6 +234,8 @@ describe('294. dataTypeVector1.js', function() {
}); // 294.1.5
it('294.1.6 update binary vector type into table', async function() {
if (!isVectorBinaryRunnable) this.skip();
const uInt8Arr1 = new Uint8Array([3, 4]);
let binds = [
{ type: oracledb.DB_TYPE_VECTOR, val: uInt8Arr1 },
@ -237,23 +263,25 @@ describe('294. dataTypeVector1.js', function() {
`SELECT VECTOR('[34.6, 77.8]', 2, float32) FROM dual`,
`SELECT VECTOR('[34.6, 77.8, -89.34]', 3, float32) FROM dual`,
`SELECT TO_VECTOR('[34.6, 77.8]', 2, float32) FROM dual`,
`SELECT TO_VECTOR('[34.6, 77.8, -89.34]', 3, float32) FROM dual`,
`SELECT TO_VECTOR('[1]', 8, binary) FROM dual`
`SELECT TO_VECTOR('[34.6, 77.8, -89.34]', 3, float32) FROM dual`
];
if (isVectorBinaryRunnable)
statements.push(`SELECT TO_VECTOR('[1]', 8, binary) FROM dual`);
/* eslint-disable no-loss-of-precision */
const expected_vectors = [
const expectedVectors = [
[34.599998474121094, 77.80000305175781],
[34.599998474121094, 77.80000305175781, -89.33999633789062],
[34.599998474121094, 77.80000305175781],
[34.599998474121094, 77.80000305175781, -89.33999633789062],
[1]
[34.599998474121094, 77.80000305175781, -89.33999633789062]
];
if (isVectorBinaryRunnable)
expectedVectors.push([1]);
for (let i = 0; i < statements.length; i++) {
const result = await connection.execute(statements[i]);
assert.deepStrictEqual(result.rows[0][0], expected_vectors[i]);
assert.deepStrictEqual(result.rows[0][0], expectedVectors[i]);
}
}); // 294.1.7
@ -354,6 +382,8 @@ describe('294. dataTypeVector1.js', function() {
}); // 294.1.12
it('294.1.13 insert a float32 vector into an Binary column (negative)', async function() {
if (!isVectorBinaryRunnable) this.skip();
// Create a Float32Array
const float32Array = new Float32Array([-5, 4, -7, 6, 2, 3, 4, 5, 6, 7, 7, 10, 11, 12, 13, 16]);
@ -434,6 +464,8 @@ describe('294. dataTypeVector1.js', function() {
}); // 294.1.16
it('294.1.17 insert a float32 typed array into an binary vector column', async function() {
if (!isVectorBinaryRunnable) this.skip();
// Create a Float32Array
const float32Array = new Float32Array([-5, 4, -7, 6, 2, 3, 4, 5, 6, 7, 7, 10, 11, 12, 13, 16]);
@ -526,6 +558,8 @@ describe('294. dataTypeVector1.js', function() {
}); // 294.1.21
it('294.1.22 insert a float64 typed array into an Binary vector column', async function() {
if (!isVectorBinaryRunnable) this.skip();
// Create a Float32Array
const float64Array = new Float64Array([-5, 4, -7, 6, 2, 3, 4, 5, 6, 7, 7, 10, 11, 12, 13, 16]);
@ -715,6 +749,7 @@ describe('294. dataTypeVector1.js', function() {
}); // 294.1.30
it('294.1.31 inserting vector binary with invalid values', async function() {
if (!isVectorBinaryRunnable) this.skip();
const sql = `INSERT INTO ${tableName} (IntCol, VectorBinaryCol)
VALUES(2, :1)`;
@ -1187,6 +1222,8 @@ describe('294. dataTypeVector1.js', function() {
}); // 294.1.48
it('294.1.49 dml returning vector binary type', async function() {
if (!isVectorBinaryRunnable) this.skip();
const sql = `INSERT INTO ${tableName} (IntCol, VectorBinaryCol)
VALUES(1, :value)
RETURNING VectorBinaryCol INTO :vector_val`;
@ -1253,6 +1290,8 @@ describe('294. dataTypeVector1.js', function() {
}); // 294.1.51
it('294.1.52 executeMany with positional args in vector binary flex column', async function() {
if (!isVectorBinaryRunnable) this.skip();
const rows = [
[1, [1, 2]],
[2, [3, 4]],
@ -1277,6 +1316,8 @@ describe('294. dataTypeVector1.js', function() {
}); // 294.1.52
it('294.1.53 handling of NULLs and default values for vector binary type', async function() {
if (!isVectorBinaryRunnable) this.skip();
// insert with default value
await connection.execute(`
INSERT INTO ${tableName} (IntCol) VALUES (1)
@ -1305,6 +1346,8 @@ describe('294. dataTypeVector1.js', function() {
}); // 294.1.53
it('294.1.54 ORDER BY and GROUP BY with vector binary type as negative test', async function() {
if (!isVectorBinaryRunnable) this.skip();
await assert.rejects(
async () => await connection.execute(`SELECT VectorFlexBinaryCol, COUNT(*) as count
FROM ${tableName}
@ -1449,6 +1492,8 @@ describe('294. dataTypeVector1.js', function() {
}); // 294.1.58
it('294.1.59 typed arrays with strings', async function() {
if (!isVectorBinaryRunnable) this.skip();
// Create a Float32Array with strings
const float32ArrayWithString = new Float32Array([1, 'invalid', 3, 4]);
@ -1489,6 +1534,8 @@ describe('294. dataTypeVector1.js', function() {
}); // 294.1.60
it('294.1.61 typed arrays with boolean values', async function() {
if (!isVectorBinaryRunnable) this.skip();
// Create a uint8Arr with boolean values
const uInt8Arr = new Uint8Array([true, false]);
// Bind the uint8Arr using oracledb.DB_TYPE_VECTOR
@ -1506,6 +1553,8 @@ describe('294. dataTypeVector1.js', function() {
}); // 294.1.61
it('294.1.62 typed arrays with undefined value in vector binary type column', async function() {
if (!isVectorBinaryRunnable) this.skip();
// Create a uint8Arr with undefined value
const uInt8Arr = new Uint8Array([1, undefined]);
@ -1524,6 +1573,8 @@ describe('294. dataTypeVector1.js', function() {
}); // 294.1.62
it('294.1.63 typed arrays with null values', async function() {
if (!isVectorBinaryRunnable) this.skip();
// Create a Float32Array with null values
const uInt8Arr = new Uint8Array([1, null]);
@ -1806,7 +1857,9 @@ describe('294. dataTypeVector1.js', function() {
it('294.2.3 fetching vector metadata', async function() {
// Using the same table name as the previous test gives an error
table = 'nodb_vectorDbTable2';
const sql = `CREATE TABLE IF NOT EXISTS ${table} (
let sql;
if (isVectorBinaryRunnable) {
sql = `CREATE TABLE IF NOT EXISTS ${table} (
IntCol NUMBER,
VectorFixedCol VECTOR(2),
Vector32Col VECTOR(10, float32),
@ -1814,17 +1867,29 @@ describe('294. dataTypeVector1.js', function() {
VectorInt8Col VECTOR(4, int8),
VectorBinaryCol VECTOR(16, binary)
)`;
} else {
sql = `CREATE TABLE IF NOT EXISTS ${table} (
IntCol NUMBER,
VectorFixedCol VECTOR(2),
Vector32Col VECTOR(10, float32),
Vector64Col VECTOR(10, float64),
VectorInt8Col VECTOR(4, int8)
)`;
}
const plsql = testsUtil.sqlCreateTable(table, sql);
await connection.execute(plsql);
const testValues = [
{ name: 'VectorFixedCol', dimensions: 2, format: undefined },
{ name: 'VectorInt8Col', dimensions: 4, format: oracledb.VECTOR_FORMAT_INT8},
{ name: 'Vector32Col', dimensions: 10, format: oracledb.VECTOR_FORMAT_FLOAT32},
{ name: 'Vector64Col', dimensions: 10, format: oracledb.VECTOR_FORMAT_FLOAT64},
{ name: 'VectorBinaryCol', dimensions: 16, format: oracledb.VECTOR_FORMAT_BINARY},
{ name: 'VectorInt8Col', dimensions: 4, format: oracledb.VECTOR_FORMAT_INT8 },
{ name: 'Vector32Col', dimensions: 10, format: oracledb.VECTOR_FORMAT_FLOAT32 },
{ name: 'Vector64Col', dimensions: 10, format: oracledb.VECTOR_FORMAT_FLOAT64 },
];
if (isVectorBinaryRunnable)
testValues.push({ name: 'VectorBinaryCol', dimensions: 16, format: oracledb.VECTOR_FORMAT_BINARY });
for (const { name, dimensions, format } of testValues) {
const vectorData = name === 'VectorBinaryCol' ?
new Uint8Array([3, 4]) : Array.from({ length: dimensions }, (_, i) => 0.125 * i);
@ -2016,6 +2081,8 @@ describe('294. dataTypeVector1.js', function() {
}); // 294.2.10
it('294.2.11 insert a uint8 vector with 65536 dimensions to flex binary column', async function() {
if (!isVectorBinaryRunnable) this.skip();
table = 'nodb_vectorDbTable1';
const sql = `CREATE TABLE IF NOT EXISTS ${table} (
IntCol NUMBER,
@ -2029,6 +2096,8 @@ describe('294. dataTypeVector1.js', function() {
}); // 294.2.11
it('294.2.12 insert a uint8 vector with max 65528 dimensions to flex binary column', async function() {
if (!isVectorBinaryRunnable) this.skip();
const arr = Array(8191).fill(1);
const vecUint8 = new Uint8Array(arr);
@ -2054,6 +2123,8 @@ describe('294. dataTypeVector1.js', function() {
}); // 294.2.12
it('294.2.13 vector binary column with no multiple of eight dimensions', async function() {
if (!isVectorBinaryRunnable) this.skip();
table = 'nodb_vectorDbTable1';
const sql = `CREATE TABLE IF NOT EXISTS ${table} (
IntCol NUMBER,

4
test/optimisticLock.js
View File

@ -334,8 +334,8 @@ describe('281. optimisticLock.js', function() {
after(async function() {
await testsUtil.dropTable(connection, 'employees');
await testsUtil.dropTable(connection, 'departments');
await connection.execute(`DROP VIEW emp_ov`);
await connection.execute(`DROP VIEW dept_ov`);
await connection.execute(`DROP VIEW IF EXISTS emp_ov`);
await connection.execute(`DROP VIEW IF EXISTS dept_ov`);
await connection.close();
});

1
test/urowidDMLBindAsString2.js
View File

@ -344,7 +344,6 @@ describe('115. urowidDMLBindAsString2.js', function() {
}
}
if (urowidLen <= 4000) {
console.log(result);
assert.strictEqual(result.rowsAffected, 1);
}