pXHhddlmZddlZddlmZddlmZddlmZddl m Z ddl m Z GddeZ Gd d eZ Gd d eZeGd dZGdde j Zy)) annotationsN) dataclass)Enum)Optional)FloatceZdZdZdZ dZy)VectorIndexTypezEnum representing different types of VECTOR index structures. See :ref:`oracle_vector_datatype` for background. .. versionadded:: 2.0.41 HNSWIVFN)__name__ __module__ __qualname____doc__r r Z/var/www/html/planif/env/lib/python3.12/site-packages/sqlalchemy/dialects/oracle/vector.pyr r s D Crr c&eZdZdZdZ dZ dZ dZy)VectorDistanceTypezEnum representing different types of vector distance metrics. See :ref:`oracle_vector_datatype` for background. .. versionadded:: 2.0.41 EUCLIDEANDOTCOSINE MANHATTANN)r r rrrrrrrrrrr(s7I CFIrrc&eZdZdZdZ dZ dZ dZy)VectorStorageFormatzEnum representing the data format used to store vector components. See :ref:`oracle_vector_datatype` for background. .. versionadded:: 2.0.41 INT8BINARYFLOAT32FLOAT64N)r r rrrrrrrrrrrGs7 DFGGrrceZdZUdZej Zded<dZded<dZ ded<dZ ded <dZ ded <dZ ded <dZ ded <dZded <dZded<dZy)VectorIndexConfigaDefine 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: interger. 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: interger. 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_partitionparallelct|j|_dD]D}t||}|t|tr#t |dt |jy)N)r$r%r&r'r(r)r#z$ must be an integer ifprovided, got )r r!getattr isinstanceint TypeErrortyper )selffieldvalues r __post_init__zVectorIndexConfig.__post_init__sl)$//:  ED%(E E3)?g%%)%[%9%9$:< r)r r rrr r r!__annotations__r"r#r$r%r&r'r(r)r3rrrr r bst0d#2"6"6J6-1H*1"Hm"$(NM()---1]1.2m237!=7"Hm"rr ceZdZdZdZdZejdejdejdejdiZ ddZ d Z d Zd ZGd d ej"j$Zy)VECTORzOracle VECTOR datatype. For complete background on using this type, see :ref:`oracle_vector_datatype`. .. versionadded:: 2.0.41 TbBfdNc|t|ts td|t|ts td||_||_y)aPConstruct 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 may be Enum values form :class:`.VectorStorageFormat` INT8, BINARY, FLOAT32, or FLOAT64. Nzdim must be an intergerz:storage_format must be an enum of type VectorStorageFormat)r,r-r.rdimstorage_format)r0r<r=s r__init__zVECTOR.__init__sT ?:c3#756 6  %j // L ,rcfd}|S)zT Convert a list to a array.array before binding it to the database. c|t|tjr|St|tr3jj}tj||}|St d)Nz$VECTOR accepts list or array.array())r,arraylist_array_typecoder=r.)r2typecoder0s rprocessz.VECTOR._cached_bind_processor..processs_} 5%++ > E4(//0C0CD He4  FGGrr)r0dialectrEs` r_cached_bind_processorzVECTOR._cached_bind_processors Hrc d}|S)zR Convert a array.array to list before binding it to the database. cNt|tjr t|Sy)N)r,rArB)r2s rrEz0VECTOR._cached_result_processor..processs%-E{".rr)r0rFcoltyperEs r_cached_result_processorzVECTOR._cached_result_processors  #rc:|jj|dS)z7 Map storage format to array typecode. r:) _typecode_mapget)r0rDs rrCzVECTOR._array_typecodes!!%%h44rceZdZdZdZdZy)VECTOR.comparator_factoryc<|jdt|S)Nz<-> return_typeoprr0others r l2_distancez%VECTOR.comparator_factory.l2_distance44775e74U; ;rc<|jdt|S)Nz<#>rRrTrVs r inner_productz'VECTOR.comparator_factory.inner_productrYrc<|jdt|S)Nz<=>rRrTrVs rcosine_distancez)VECTOR.comparator_factory.cosine_distance rYrN)r r rrXr[r]rrrcomparator_factoryrPs < < rGrKrCtypes TypeEngine Comparatorr^rrrr6r6stHN   #""C##S##S M-,( 5 risq# ! "d&>$6 MM M`W