+ }j?*^RIHt^RIt^RIHt^RIHt^RIHt^RIH t ^RI H t ^RI H t !R R ]4t !R R ]4t!R R]4t!RR]4t]!RR44t!RR4t!RR] P&4tR#)) annotationsN) dataclass)Enum)Optional)Union)types)Floatc$]tRt^tRtRtRtRtR#)VectorIndexTypezEnum representing different types of VECTOR index structures. See :ref:`oracle_vector_datatype` for background. .. versionadded:: 2.0.41 HNSWIVFN)__name__ __module__ __qualname____firstlineno____doc__r r __static_attributes__rb/home/luca/screen-checking/.venv/lib/python3.14/site-packages/sqlalchemy/dialects/oracle/vector.pyr r s D Crr c0]tRt^)tRtRtRtRtRtRt R#)VectorDistanceTypezEnum representing different types of vector distance metrics. See :ref:`oracle_vector_datatype` for background. .. versionadded:: 2.0.41 EUCLIDEANDOTCOSINE MANHATTANrN) rrrrrrrrrrrrrrr)s7I CFIrrc0]tRt^HtRtRtRtRtRtRt R#)VectorStorageFormatzEnum representing the data format used to store vector components. See :ref:`oracle_vector_datatype` for background. .. versionadded:: 2.0.41 INT8BINARYFLOAT32FLOAT64rN) rrrrrrr r!r"rrrrrrHs7 DFGGrrc$]tRt^ctRtRtRtRtR#)VectorStorageTypezqEnum representing the vector type, See :ref:`oracle_vector_datatype` for background. .. versionadded:: 2.0.43 SPARSEDENSErN)rrrrrr%r&rrrrr$r$csF Err$c]tRt^xt$Rt]P tR]R&Rt R]R&Rt R]R&Rt R]R &Rt R]R &Rt R]R &RtR]R &RtR]R &RtR]R&RtRtR#)VectorIndexConfiga6Define the configuration for Oracle VECTOR Index. See :ref:`oracle_vector_datatype` for background. .. versionadded:: 2.0.41 :param index_type: Enum value from :class:`.VectorIndexType` Specifies the indexing method. For HNSW, this must be :attr:`.VectorIndexType.HNSW`. :param distance: Enum value from :class:`.VectorDistanceType` specifies the metric for calculating distance between VECTORS. :param accuracy: integer. Should be in the range 0 to 100 Specifies the accuracy of the nearest neighbor search during query execution. :param parallel: integer. Specifies degree of parallelism. :param hnsw_neighbors: integer. Should be in the range 0 to 2048. Specifies the number of nearest neighbors considered during the search. The attribute :attr:`.VectorIndexConfig.hnsw_neighbors` is HNSW index specific. :param hnsw_efconstruction: integer. Should be in the range 0 to 65535. Controls the trade-off between indexing speed and recall quality during index construction. The attribute :attr:`.VectorIndexConfig.hnsw_efconstruction` is HNSW index specific. :param ivf_neighbor_partitions: integer. Should be in the range 0 to 10,000,000. Specifies the number of partitions used to divide the dataset. The attribute :attr:`.VectorIndexConfig.ivf_neighbor_partitions` is IVF index specific. :param ivf_sample_per_partition: integer. Should be between 1 and ``num_vectors / neighbor partitions``. Specifies the number of samples used per partition. The attribute :attr:`.VectorIndexConfig.ivf_sample_per_partition` is IVF index specific. :param ivf_min_vectors_per_partition: integer. From 0 (no trimming) to the total number of vectors (results in 1 partition). Specifies the minimum number of vectors per partition. The attribute :attr:`.VectorIndexConfig.ivf_min_vectors_per_partition` is IVF index specific. r index_typeNzOptional[VectorDistanceType]distancez Optional[int]accuracyhnsw_neighborshnsw_efconstructionivf_neighbor_partitionsivf_sample_per_partitionivf_min_vectors_per_partitionparallelc \VP4VnRFMp\W4pVfK\V\4'dK,\ V R\ V4P 24h R#)r,Nz$ must be an integer ifprovided, got )r,r-r.r/r0r1r+)r r)getattr isinstanceint TypeErrortyper)selffieldvalues& r __post_init__VectorIndexConfig.__post_init__sh)$//: ED(E E3)?)?g%%)%[%9%9$:< r)r))rrrrrr r r)__annotations__r*r+r,r-r.r/r0r1r;rrrrr(r(xst0d#2"6"6J6-1H*1"Hm"$(NM()---1]1.2m237!=7"Hm"rr(c,]tRt^tRtRRltRtRtR#) SparseVectorzt Lightweight SQLAlchemy-side version of SparseVector. This mimics oracledb.SparseVector. .. versionadded:: 2.0.43 c$V^8dQhRRRRRR/#)num_dimensionsr5indiceszUnion[list, array.array]valuesr)formats"r __annotate__SparseVector.__annotate__s(*) rc p\V\P4'dVPR8wd\P!RV4p\V\P4'g\P!RV4p\V4\V48wd \ R4hWnW nW0nR#)Idz.indices and values must be of the same length!N)r4arraytypecodelenr6rBrCrD)r8rBrCrDs&&&&r__init__SparseVector.__init__s '5;;//73C3Cs3Jkk#w/G&%++..[[f-F w<3v; &LM M,  rc |RVP R\VP4 RVPP R2#)zSparseVector(num_dimensions=z, size=z , typecode=))rBrMrCrDrL)r8s&r__str__SparseVector.__str__sC*4+>+>*?@ %&k$++2F2F1Gq J r)rCrBrDN)rrrrrrNrRrrrrr?r?s" rr?c]tRt^tRtRtRt]PR]PR]PR]PR/t RRlt R tR tR t!R R ]P$P&4tRtR#)VECTORzOracle VECTOR datatype. For complete background on using this type, see :ref:`oracle_vector_datatype`. .. versionadded:: 2.0.41 TbBfrJNc Ve"\V\4'g \R4hVe"\V\4'g \R4hVe"\V\4'g \R4hWnW nW0nR#)aConstruct a VECTOR. :param dim: integer. The dimension of the VECTOR datatype. This should be an integer value. :param storage_format: VectorStorageFormat. The VECTOR storage type format. This should be Enum values form :class:`.VectorStorageFormat` INT8, BINARY, FLOAT32, or FLOAT64. :param storage_type: VectorStorageType. The Vector storage type. This should be Enum values from :class:`.VectorStorageType` SPARSE or DENSE. Nzdim must be an integerz:storage_format must be an enum of type VectorStorageFormatz6storage_type must be an enum of type VectorStorageType)r4r5r6rr$dimstorage_format storage_type)r8rZr[r\s&&&&rrNVECTOR.__init__s ?:c3#7#745 5  %j // / L   #J +- - H ,(rc aaVV3RlpV#)z Converts a Python-side SparseVector instance into an oracledb.SparseVectormor a compatible array format before binding it to the database. c<Ve!\V\P4'dV#\V\4'd4SPSP4p\P!W4pV#\V\ 4'd<SP P VPVPVP4#\R4h)Nz Invalid input for VECTOR: expected a list, an array.array, or a SparseVector object. ) r4rKlist_array_typecoder[r?dbapirBrCrDr6)r:rLdialectr8s& rprocess.VECTOR._cached_bind_processor..process)s} 5%++ > > E4((//0C0CD H4 E<00}}11((MMLL !rr)r8rcrdsff r_cached_bind_processorVECTOR._cached_bind_processor"s 0rc aV3RlpV#)z Converts database-returned values into Python-native representations. If the value is an oracledb.SparseVector, it is converted into the SQLAlchemy-side SparseVector class. If the value is a array.array, it is converted to a plain Python list. c<VfR#\V\P4'd \V4#\VSPP4'd-\ VP VP VPR7#R#)N)rBrCrD)r4rKr`rbr?rBrCrD)r:rcs&rrd0VECTOR._cached_result_processor..processLsh}E5;;//E{"E7==#=#=>>##(#7#7!MM <<?rr)r8rccoltyperds&f& r_cached_result_processorVECTOR._cached_result_processorCs rc :VPPVR4#)z' Map storage format to array typecode. rJ) _typecode_mapget)r8rLs&&rraVECTOR._array_typecode]s!!%%h44rc(]tRtRtRtRtRtRtR#)VECTOR.comparator_factoryicc <VPR\R7!V4#)z<-> return_typeopr r8others&&r l2_distance%VECTOR.comparator_factory.l2_distanced775e74U; ;rc <VPR\R7!V4#)z<#>rurwrys&&r inner_product'VECTOR.comparator_factory.inner_productgr}rc <VPR\R7!V4#)z<=>rurwrys&&rcosine_distance)VECTOR.comparator_factory.cosine_distancejr}rrN)rrrrr{rrrrrrcomparator_factoryrscs < < rs# !d&>$6* MM M`  BA