Ë
    kQêjæ³  ã                   óF  — d dl mZ d dlZd dlZd dlmZmZ d dlZd dlm	Z	m
Z
mZmZmZmZmZmZmZmZ d dlZd dlmZ d dlmZ d dlmZmZmZmZmZmZmZm Z m!Z!m"Z"m#Z# d dl$m%Z% d d	l&m'Z' d d
l(m)Z)m*Z*m+Z+m,Z, d dl-m.Z. d dl/m0Z0m1Z1 d dl2m3Z3 d dl4m5Z5m6Z6 d dl7Z8d dl9m:Z:m;Z;m<Z< d dlm=Z= d dl>m?Z? d dl@mAZA d dl4mBZB ddlCmDZDmEZEmFZFmGZGmHZH ddlImJZJmKZKmLZLmMZMmNZNmOZOmPZPmQZQ ddlRmSZSmTZT ddlUmVZV e	rd dlWZWd dlXZYdeZdeZfd„Z[ G d„ deP«      Z\de8j                   de]d e8j                   fd!„Z^y)"é    )Ú	timedeltaN)Úcached_propertyÚwraps)
ÚTYPE_CHECKINGÚAnyÚCallableÚDictÚIterableÚListÚOptionalÚUnionÚLiteralÚoverload)Ú__version__)ÚBlobFile)ÚAddColumnsResultÚ	AddResultÚAlterColumnsResultÚUpdateFieldMetadataResultÚDeleteResultÚDropColumnsResultÚFtsTokenÚIndexConfigÚRTEWriteSpecÚMergeResultÚUpdateResult)ÚEmbeddingFunctionConfig)ÚExpr)ÚFTSÚBTreeÚBitmapÚ	LabelList)ÚJob)ÚFunctionApplicationÚRefreshColumnResult)ÚLOOP)ÚIndexConfigTypeÚ_maybe_add_fts_error_note)ÚDATAÚVECÚVECTOR_COLUMN_NAME)Úvalidate_blob_mode)ÚLanceMergeInsertBuilder)ÚEmbeddingFunctionRegistry)Ú_normalize_progressé   )ÚAnalyzePlanDistributedMetricsÚDocumentGranularityÚFullTextQueryÚLanceQueryBuilderÚLanceTakeQueryBuilder)Ú
AsyncTableÚBlobModeÚBranchesÚCompactionOptionsÚIndexStatisticsÚQueryÚTableÚTags)ÚBaseTokenizerTypeÚScalarIndexType)Úinfer_vector_column_nameÚold_nameÚnew_namec                 ó   ‡ ‡— ˆˆ fd„}|S )zHKeep old remote-only keyword names without changing the Table signature.c                 ó4   •‡ — t        ‰ «      ˆ ˆˆfd„«       }|S )Nc                 óº   •— ‰|v rK‰|v rt        d‰› d‰› �«      ‚t        j                  ‰› d‰› d�t        d¬«       |j	                  ‰«      |‰<    ‰| g|¢­i |¤ŽS )NzCannot specify both z and z is deprecated; use z insteadr0   ©Ú
stacklevel)Ú	TypeErrorÚwarningsÚwarnÚDeprecationWarningÚpop)ÚselfÚargsÚkwargsÚmethodrB   rA   s      €€€úY/home/oem/CyberBrain26-unified/.venv/lib/python3.12/site-packages/lancedb/remote/table.pyÚwrappedz6_deprecated_keyword.<locals>.decorate.<locals>.wrappedX   sy   ø€ à˜6Ñ!Ø˜vÑ%Ü#Ð&:¸8¸*ÀEÈ(ÈÐ$TÓUÐUÜ—‘Ø�jÐ 4°X°J¸hÐGÜ&Ø õð
 $*§:¡:¨hÓ#7��xÑ Ù˜$Ð0 Ò0¨Ñ0Ð0ó    )r   )rP   rR   rB   rA   s   ` €€rQ   Údecoratez%_deprecated_keyword.<locals>.decorateW   s    ù€ Ü	ˆv‹õ
	1ó 
ð
	1ð ˆrS   © )rA   rB   rT   s   `` rQ   Ú_deprecated_keywordrV   T   s   ù€ õð  €OrS   c            0       óf  ‡ — e Zd Zdddœdededeeeeg ef   f      deee      fd„Z	defd	„Z
edefd
„«       Zej                  deddfd„«       Zdâd„Zdefd„Zdeddfd„Zedefd„«       Zedee   fd„«       Z ej*                  ded¬«      dedeeef   fd„«       Zdefd„Zedej6                  fd„«       Zedefd„«       Zedefd„«       Z ede!fd„«       Z"dee   fd„Z#	 dãdedee   dd fd „Z$e%deee&f   fd!„«       Z'd"„ Z(d#d$œd%e)dejT                  fd&„Z+däd%e)fd'„Z,dåd(„Z-dãdæd)„Z.deeef   fd*„Z/d+„ Z0dãdeeeef      fd,„Z1de2e3   fd-„Z4ddd.œd/ed0ee   d1ee   de2e5   fd2„Z6 e7d3d1«      d1edee8   fd4„«       Z9 ej*                  d5ed6¬«      d7d8ddd9œd0ed:e:d;e;d<ee<   d=ee   f
d>„«       Z= ej*                  d5ed?¬«       e7d0d@«      ddAdBdAddAdCdDdEd7dddd7dFdFdAdGe>j~                  dddHœd@eeee   f   dIeeeee   f      d:e:dJee   dKe:dLee   dMe:dNe@dOedPee   dQe:dRee:   dSee:   dTeee      dUe:dVedWedXe:dYedZe>d<ee<   d=ee   f,d[„«       «       ZAeBd\d\d\d\d]œd0ed^eCd:e:d<ee<   d=ee   d_e:ddfd`„«       ZDeB	 	 	 	 	 	 	 	 	 	 	 	 	 dçd\d\d\d\daœdbeEdc   ddee   deee   dfed:e:dgee   dhee   died;eEdj   dkedledmedned<ee<   d=ee   d_e:doee   ddf$dp„«       ZDdqddeFd7dddrdsdtdudvdwfdddd7ddxœdbeddee   deee   dfed:e:dgee   dhee   died;eEdy   dkedledmedned^eeC   d<ee<   d=ee   d_e:doee   f$dz„ZDdddd7d]œd0ed^eCd:ee:   d<ee<   d=ee   d_e:deGfd{„ZH	 	 	 	 	 	 dèd|eId}ed~edeJd€eee:eeKf      d�ee   d‚e:deLfdƒ„ZM	 	 	 	 	 	 déd/eeNef   dfee   d„ee   d…eeeee   f      d†ee:   deOfd‡„ZPdddˆœd/eQd‰ee   dŠee<   dej¤                  fd‹„ZSdêd/eQdŒee:   defd�„ZTdŽd�œd/eQd�eUdefd‘„ZVd/eQdej6                  fd’„ZWd“eee2e   f   deXfˆ fd”„ZYd•eXd–eId~edeJdeZf
d—„Z[ e7d˜d™«      d™eee\f   de]fdš„«       Z^	 	 dëdd›œd™eeee\f      dœee   d�eeeef      de_fdž„Z`	 dãdAdŸœd ee<   d¡e:fd¢„Zad£„ ZbddAdAdd¤œd¥ee<   d¡e:d¦e:d§eec   fd¨„Zddãd©ee   defdª„Ze	 dãdddd«œd¬eeeefz  f   efz  ejÎ                  z  eejÎ                     z  ej6                  z  dz  d­eeef   dz  d®e:dz  d¯edz  dehf
d°„Zid0efd±„Zjd0edeGek   fd²„Zl	 	 	 dìd³ee   d0ee   d´ee   fdµ„Zmd¶e2eeef      denfd·„Zod¸eeeKf   depfd¹„Zqdºe2e   derfd»„Zsdºeee2e   f   ddfd¼„Ztdíd¾„Zudâd¿„Zvded½   fdÀ„Zwde:fdÁ„ZxdâdÂ„ZydâdÃ„ZzdâdÄ„Z{dâdÅ„Z|dAdÆœdÇe:dee   fdÈ„Z}dâdÉ„Z~ e7d1d=«      d=eddfdÊ„«       Zd=eddfdË„Z€dãdºeee      ddfdÌ„Z� e<dw¬Í«      fdÎe2e   dŠe<fdÏ„Z‚dÐ„ ZƒedefdÑ„«       Z„dAdÒœdÓe…e   dÔe:de†fdÕ„Z‡dAdÒœdÖe…e   dÔe:de†fd×„Zˆde:fdØ„Z‰dÙ„ ZŠde…e   fdÚ„Z‹d0edÖee…e   e�j                  e�j                  ejT                  f   de�j                  fdÛ„Z�d0ede�j                  fdÜ„Z�d0edÖee…e   e�j                  e�j                  ejT                  f   ddÝfdÞ„Z‘dßeee�j$                  df   dee“   fdà„Z”dîdejT                  fdá„Z•ˆ xZ–S )ïÚRemoteTableN©Úconnection_stateÚnamespace_pathÚtableÚdb_namerZ   r[   c                óÆ   — || _         |j                  | _        || _        || _        t        |xs g «      | _        d | _        d | _        t        j                  «       | _        y ©N)Ú_table_handleÚnameÚ_namer]   Ú_connection_stateÚlistÚ_namespace_pathÚ_checkout_versionÚ_branchÚosÚgetpidÚ_pid)rM   r\   r]   rZ   r[   s        rQ   Ú__init__zRemoteTable.__init__k   sV   € ð #ˆÔØ—Z‘ZˆŒ
ØˆŒØ!1ˆÔÜ# NÒ$8°bÓ9ˆÔØ04ˆÔð '+ˆŒÜ—I‘I“Kˆ�	rS   Úreturnc                 óœ   — | j                   €t        d«      ‚t        | j                   «      r| j                  «       | _         | j                   S )NzUCannot reopen this remote table because it does not carry serialized connection state)rc   ÚRuntimeErrorÚcallable©rM   s    rQ   Ú_serialized_connection_statez(RemoteTable._serialized_connection_state~   sM   € Ø×!Ñ!Ð)Üð.óð ô �D×*Ñ*Ô+Ø%)×%;Ñ%;Ó%=ˆDÔ"Ø×%Ñ%Ð%rS   c                 óV   — | j                  «        | j                  €J ‚| j                  S r_   )Ú_ensure_openr`   rp   s    rQ   Ú_tablezRemoteTable._tableˆ   s,   € à×ÑÔØ×!Ñ!Ð-Ð-Ð-Ø×!Ñ!Ð!rS   c                 óf   — || _         |j                  | _        t        j                  «       | _        y r_   )r`   ra   rb   rh   ri   rj   )rM   r\   s     rQ   rt   zRemoteTable._tableŽ   s"   € à"ˆÔØ—Z‘ZˆŒ
Ü—I‘I“Kˆ�	rS   c                 ól  — t        j                  «       }| j                  �| j                  |k(  ry ddlm}  || j                  «       d¬«      }|j                  | j                  | j                  | j                  | j                  ¬«      }|j                  | _        |j                  | _        || _        y )Nr   )Údeserialize_connT)Ú
for_worker)r[   ÚbranchÚversion)rh   ri   r`   rj   Úlancedbrw   rq   Ú
open_tablerb   re   rg   rf   rt   r]   )rM   Úpidrw   Údbr\   s        rQ   rs   zRemoteTable._ensure_open”   s–   € Ü�i‰i‹kˆØ×ÑÐ)¨d¯i©i¸3Ò.>Øõ 	-á˜d×?Ñ?ÓAÈdÔSˆð —‘Ø�J‰JØ×/Ñ/Ø—<‘<Ø×*Ñ*ð	 ó 
ˆð #Ÿ\™\ˆÔØ—}‘}ˆŒØˆ�	rS   c                 ó”   — | j                  «       | j                  | j                  | j                  | j                  | j
                  dœS )N)rZ   r]   ra   r[   Úcheckout_versionry   )rq   r]   ra   re   rf   rg   rp   s    rQ   Ú__getstate__zRemoteTable.__getstate__«   s?   € à $× AÑ AÓ CØ—|‘|Ø—I‘IØ"×2Ñ2Ø $× 6Ñ 6Ø—l‘lñ
ð 	
rS   Ústatec                 ó°   — d | _         |d   | _        |d   | _        |d   | _        |d   | _        |d   | _        |j                  d«      | _        d | _        y )Nra   r]   rZ   r[   r€   ry   )	r`   rb   r]   rc   re   rf   Úgetrg   rj   )rM   r‚   s     rQ   Ú__setstate__zRemoteTable.__setstate__µ   sb   € Ø!ˆÔØ˜6‘]ˆŒ
Ø˜YÑ'ˆŒØ!&Ð'9Ñ!:ˆÔØ$Ð%5Ñ6ˆÔØ!&Ð'9Ñ!:ˆÔØ—y‘y Ó*ˆŒØˆ�	rS   c                 ó   — | j                   S )zThe name of the table)rb   rp   s    rQ   ra   zRemoteTable.name¿   s   € ð �z‰zÐrS   c                 ó   — | j                   S r_   )re   rp   s    rQ   Ú	namespacezRemoteTable.namespaceÄ   s   € à×#Ñ#Ð#rS   z0.33.1z$Use update_field_metadata() instead.)Údeprecated_inÚcurrent_versionÚdetailsÚ
field_nameÚnew_metadatac                 ób   — t        j                  | j                  j                  ||«      «       y r_   )r&   Úrunrt   Úreplace_field_metadata)rM   rŒ   r�   s      rQ   r�   z"RemoteTable.replace_field_metadataÈ   s!   € ô 	�‰�—‘×3Ñ3°JÀÓMÕNrS   c                 ó<   — d| j                   › d| j                  › d�S )NzRemoteTable(ú.ú))r]   ra   rp   s    rQ   Ú__repr__zRemoteTable.__repr__Ð   s   € Ø˜dŸl™l˜^¨1¨T¯Y©Y¨K°qÐ9Ð9rS   c                 ó\   — t        j                  | j                  j                  «       «      S )zlThe [Arrow Schema](https://arrow.apache.org/docs/python/api/datatypes.html#)
        of this Table

        )r&   r�   rt   Úschemarp   s    rQ   r–   zRemoteTable.schemaÓ   s    € ô �x‰x˜Ÿ™×*Ñ*Ó,Ó-Ð-rS   c                 ó\   — t        j                  | j                  j                  «       «      S )z$Get the current version of the table)r&   r�   rt   rz   rp   s    rQ   rz   zRemoteTable.versionÛ   s    € ô �x‰x˜Ÿ™×+Ñ+Ó-Ó.Ð.rS   c                 ó,   — t        | j                  «      S r_   )r=   rt   rp   s    rQ   ÚtagszRemoteTable.tagsà   s   € ä�D—K‘KÓ Ð rS   c                 ó   — t        | «      S )z§Branch management for the table.

        ``create``/``checkout`` return a new table handle scoped to the branch;
        writes on it do not affect ``main``.
        )r8   rp   s    rQ   ÚbrancheszRemoteTable.branchesä   s   € ô ˜‹~ÐrS   c                 ó6   — | j                   j                  «       S )zDThe branch this table handle is scoped to, or ``None`` for ``main``.)rt   Úcurrent_branchrp   s    rQ   r�   zRemoteTable.current_branchí   s   € à�{‰{×)Ñ)Ó+Ð+rS   Úasync_tablerz   c                 ó˜   — t        || j                  | j                  | j                  ¬«      }|j	                  «       |_        ||_        |S )NrY   )rX   r]   rc   re   r�   rg   rf   )rM   rž   rz   Úhandles       rQ   Ú_wrap_branch_handlezRemoteTable._wrap_branch_handleñ   sI   € ô
 ØØ�L‰LØ!×3Ñ3Ø×/Ñ/ô	
ˆð %×3Ñ3Ó5ˆŒØ#*ˆÔ ØˆrS   c                 óp   — t        j                  «       j                  | j                  j                  «      S )zâ
        Get the embedding functions for the table

        Returns
        -------
        funcs: dict
            A mapping of the vector column to the embedding function
            or empty dict if not configured.
        )r.   Úget_instanceÚparse_functionsr–   Úmetadatarp   s    rQ   Úembedding_functionszRemoteTable.embedding_functions   s-   € ô )×5Ñ5Ó7×GÑGØ�K‰K× Ñ ó
ð 	
rS   c                 ó\   — t        j                  | j                  j                  «       «      S )zList all versions of the table)r&   r�   rt   Úlist_versionsrp   s    rQ   r¨   zRemoteTable.list_versions  s   € ä�x‰x˜Ÿ™×1Ñ1Ó3Ó4Ð4rS   Úlazy)Ú	blob_moderª   c                ó.   — t        |«       t        d«      ‚)z.to_arrow() is not supported for remote tables.zUto_arrow() is not supported for remote tables. Use table.search().to_arrow() instead.©r,   ÚNotImplementedError)rM   rª   s     rQ   Úto_arrowzRemoteTable.to_arrow  s   € ä˜9Ô%Ü!ð5ó
ð 	
rS   c                 ó.   — t        |«       t        d«      ‚)z/to_pandas() is not supported for remote tables.zWto_pandas() is not supported for remote tables. Use table.search().to_pandas() instead.r¬   )rM   rª   rO   s      rQ   Ú	to_pandaszRemoteTable.to_pandas  s   € ä˜9Ô%Ü!ð6ó
ð 	
rS   c                 ó`   — t        j                   | j                  j                  di |¤Ž«      S )z�Direct Lance dataset access is not supported for remote tables.

        Use ``table.search().to_arrow()`` to read query results through the server.
        rU   )r&   r�   rt   Úto_lance)rM   rO   s     rQ   r²   zRemoteTable.to_lance#  s(   € ô
 �x‰xÐ,˜Ÿ™×,Ñ,Ñ6¨vÑ6Ó7Ð7rS   c                 ó   — t        d«      ‚)z@Use ``table.search().to_polars()`` to read remote query results.zWto_polars() is not supported for remote tables. Use table.search().to_polars() instead.)r­   )rM   Ú
batch_sizes     rQ   Ú	to_polarszRemoteTable.to_polars*  s   € ä!ð6ó
ð 	
rS   c                 ó„   — t        j                  | j                  j                  |«      «      }| j                  | _        |S r_   )r&   r�   rt   Úcheckoutrz   rf   ©rM   rz   Úresults      rQ   r·   zRemoteTable.checkout1  s0   € Ü—‘˜$Ÿ+™+×.Ñ.¨wÓ7Ó8ˆØ!%§¡ˆÔØˆrS   c                 ón   — t        j                  | j                  j                  «       «      }d | _        |S r_   )r&   r�   rt   Úcheckout_latestrf   )rM   r¹   s     rQ   r»   zRemoteTable.checkout_latest6  s*   € Ü—‘˜$Ÿ+™+×5Ñ5Ó7Ó8ˆØ!%ˆÔØˆrS   c                 óp   — t        j                  | j                  j                  |«      «      }d | _        |S r_   )r&   r�   rt   Úrestorerf   r¸   s      rQ   r½   zRemoteTable.restore;  s,   € Ü—‘˜$Ÿ+™+×-Ñ-¨gÓ6Ó7ˆØ!%ˆÔØˆrS   c                 ó\   — t        j                  | j                  j                  «       «      S )z!List all the indices on the table)r&   r�   rt   Úlist_indicesrp   s    rQ   r¿   zRemoteTable.list_indices@  ó   € ä�x‰x˜Ÿ™×0Ñ0Ó2Ó3Ð3rS   ©ÚcolumnÚ
index_nameÚqueryrÂ   rÃ   c                ód   — t        j                  | j                  j                  |||¬«      «      S )aJ  Tokenize a query using the tokenizer configured on an FTS index.

        Model-backed tokenizers such as ``jieba/*`` and ``lindera/*`` are
        rebuilt in the client process from index metadata. For remote tables,
        this means the same tokenizer model files must also exist locally
        (under ``LANCE_LANGUAGE_MODEL_HOME``) and must match the files the
        server uses. A mismatch cannot be detected: the returned tokens may
        differ from what the server's index produces. If the model files are
        missing, an error naming the tokenizer is raised.
        rÁ   )r&   r�   rt   Útokenize)rM   rÄ   rÂ   rÃ   s       rQ   rÆ   zRemoteTable.tokenizeD  s.   € ô" �x‰xØ�K‰K× Ñ  ¨vÀ*Ð ÓMó
ð 	
rS   Ú
index_uuidc                 ó^   — t        j                  | j                  j                  |«      «      S )z'List all the stats of a specified index)r&   r�   rt   Úindex_stats)rM   rÃ   s     rQ   rÉ   zRemoteTable.index_statsY  s"   € ô �x‰x˜Ÿ™×/Ñ/°
Ó;Ó<Ð<rS   z0.25.0zDUse create_index() with config=BTree()/Bitmap()/LabelList() instead.TÚBTREE)ÚreplaceÚ
index_typeÚwait_timeoutra   rË   rÌ   rÍ   ra   c          	      ó*  — |dk(  rt        j                  dt        d¬«       d}|dk(  rt        «       }n.|dk(  rt	        «       }n|dk(  rt        «       }nt        d|› �«      ‚t        j                  | j                  j                  |||||¬	«      «      S )
zéCreate a scalar index on a column.

        .. deprecated:: 0.25.0
            Use :meth:`create_index` with a BTree, Bitmap, or LabelList config instead.
            Example: ``table.create_index("column", config=BTree())``
        Úscalarz6index_type="scalar" is deprecated; use "BTREE" insteadr0   rF   rÊ   ÚBITMAPÚ
LABEL_LISTzUnknown index type )rË   ÚconfigrÍ   ra   )rI   rJ   rK   r    r!   r"   Ú
ValueErrorr&   r�   rt   Úcreate_index)rM   rÂ   rË   rÌ   rÍ   ra   rÒ   s          rQ   Úcreate_scalar_indexzRemoteTable.create_scalar_index^  sŸ   € ð( ˜Ò!Ü�M‰MØHÜ"Øõð
 !ˆJØ˜Ò Ü“W‰FØ˜8Ò#Ü“X‰FØ˜<Ò'Ü“[‰FäÐ2°:°,Ð?Ó@Ð@Ü�x‰xØ�K‰K×$Ñ$ØØØØ)Øð %ó ó
ð 	
rS   z-Use create_index() with config=FTS() instead.Úfield_namesFé   @ÚsimpleÚEnglishé(   é   é€   )Úordering_field_namesrË   Úwriter_heap_sizeÚuse_tantivyÚtokenizer_nameÚwith_positionÚbase_tokenizerÚlanguageÚmax_token_lengthÚ
lower_caseÚstemÚremove_stop_wordsÚcustom_stop_wordsÚascii_foldingÚngram_min_lengthÚngram_max_lengthÚprefix_onlyÚ
block_sizeÚdocument_granularityrÍ   ra   rÝ   rÞ   rß   rà   rá   râ   rã   rä   rå   ræ   rç   rè   ré   rê   rë   rì   rí   rî   c                óØ  — |rt        d«      ‚|�t        d«      ‚|dk7  rt        d«      ‚t        |t        «      st        d«      ‚|€||	||
||||||||dœ}n| j                  |«      }||d<   t	        d||d	œ|¤Ž}	 t        j                  | j                  j                  |||||¬
«      «       y# t         t        f$ r)}t        ||j                  |j                  ¬«       |‚d}~ww xY w)zßCreate a full-text search index on a column.

        .. deprecated:: 0.25.0
            Use :meth:`create_index` with an FTS config instead.
            Example: ``table.create_index("text_column", config=FTS())``
        z^Tantivy-based FTS has been removed. Remove use_tantivy and recreate the index with native FTS.NzXordering_field_names was only supported by the removed Tantivy-based FTS implementation.r×   zTwriter_heap_size was only supported by the removed Tantivy-based FTS implementation.z”Native FTS indexes can only be created on a single field at a time. To search over multiple text fields, create a separate FTS index for each field.)râ   rã   rá   rä   rå   ræ   rç   rè   ré   rê   rë   rì   rè   )rí   rî   )rË   rÒ   ra   rÍ   )râ   rã   rU   )rÓ   Ú
isinstanceÚstrÚinfer_tokenizer_configsr   r&   r�   rt   rÔ   rn   r(   râ   rã   )rM   rÖ   rÝ   rË   rÞ   rß   rà   rá   râ   rã   rä   rå   ræ   rç   rè   ré   rê   rë   rì   rí   rî   rÍ   ra   Útokenizer_configsrÒ   Úes                             rQ   Úcreate_fts_indexzRemoteTable.create_fts_index‹  sR  € ñN ÜðMóð ð  Ð+Üð4óð ð Ð1Ò1Üð4óð ô ˜+¤sÔ+Üð5óð ð Ð!à"0Ø$Ø!.Ø$4Ø(ØØ%6Ø%6Ø!.Ø$4Ø$4Ø*ñ!Ñð !%× <Ñ <¸^Ó LÐØ5FÐÐ1Ñ2äð 
Ø!Ø!5ñ
ð  ñ
ˆð	Ü�H‰HØ—‘×(Ñ(ØØ#Ø!ØØ!-ð )ó õøô œLÐ)ò 	Ü%ØØ%×4Ñ4ØŸ™õð
 ˆGûð	ús   Á=3B1 Â1C)Ã $C$Ã$C).)rË   rÍ   ra   ÚtrainrÒ   rö   c                ó   — y r_   rU   ©rM   rÂ   rÒ   rË   rÍ   ra   rö   s          rQ   rÔ   zRemoteTable.create_indexô  s   € ð rS   )rÍ   ra   rö   Útarget_partition_sizeÚmetric)Úl2ÚcosineÚdotÚhammingÚnum_partitionsÚnum_sub_vectorsÚvector_column_nameÚacceleratorÚindex_cache_sizeÚnum_bits)ÚIVF_FLATÚIVF_SQÚIVF_PQÚIVF_RQÚIVF_HNSW_SQÚIVF_HNSW_PQÚmax_iterationsÚsample_rateÚmÚef_constructionrù   c                 ó   — y r_   rU   )rM   rú   rÿ   r   r  rË   r  r  r  rÌ   r  r  r  r  rÍ   ra   rö   rù   s                     rQ   rÔ   zRemoteTable.create_index  s   € ð. rS   rû   é   r  é2   é   é   i,  )rÒ   rÍ   ra   rö   rù   )r  r  r  r  r	  r
  ÚIVF_HNSW_FLATc                óŠ  — | j                  |||||||«      }|rut        j                  dt        d¬«       |}|�t	        j
                  d«       | j                  ||	j                  «       dk(  rdn|	j                  «       ||||
||||d¬«      }n|}t        j                  | j                  j                  ||||||¬	«      «      S )
aë  Create an index on a column.

        This method supports both the new unified API and the legacy API
        for backwards compatibility. The new API takes the column name as the
        first positional argument and an index configuration object via
        ``config``; the legacy API takes the distance metric as the first
        argument plus separate ``vector_column_name`` / ``num_partitions`` /
        etc. parameters, and emits a ``DeprecationWarning``.

        Parameters
        ----------
        metric : str
            For new API: the column name to index.
            For legacy API: the distance metric ("l2", "cosine", "dot", "hamming").
        config : IndexConfigType, optional
            The index configuration object. If provided, uses the new unified API.
            Can be one of: IvfFlat, IvfPq, IvfSq, IvfRq, HnswPq, HnswSq,
            BTree, Bitmap, LabelList, Fm, FTS.
        replace : bool, default True
            Whether to replace an existing index on this column.
        wait_timeout : timedelta, optional
            Timeout to wait for async indexing to complete.
        name : str, optional
            Custom name for the index.
        train : bool, default True
            Whether to train the index with existing data.

        Examples
        --------
        New API (recommended):

        >>> table.create_index(  # doctest: +SKIP
        ...     "vector", config=IvfPq(distance_type="l2")
        ... )
        >>> table.create_index("category", config=BTree())  # doctest: +SKIP
        >>> table.create_index("content", config=FTS())  # doctest: +SKIP

        Legacy API (deprecated):

        >>> table.create_index(  # doctest: +SKIP
        ...     "l2", vector_column_name="vector"
        ... )
        aF  The create_index() API with metric/num_partitions parameters is deprecated and will be removed in a future version. Please migrate to the new unified API:
  # Old (deprecated):
  table.create_index('l2', vector_column_name='my_vector')
  # New (recommended):
  table.create_index('my_vector', config=IvfPq(distance_type='l2'))r0   rF   NzGGPU accelerator is not supported for remote tables and will be ignored.ÚVECTORr  )rú   rÌ   rÿ   r   r  r  r  r  r  rù   r  ©rË   rÒ   rÍ   ra   rö   )Ú_is_legacy_create_index_callrI   rJ   rK   ÚloggingÚwarningÚ'_build_vector_config_from_legacy_paramsÚupperr&   r�   rt   rÔ   )rM   rú   rÿ   r   r  rË   r  r  r  rÌ   r  r  r  r  rÒ   rÍ   ra   rö   rù   Ú	is_legacyrÂ   s                        rQ   rÔ   zRemoteTable.create_index  s   € ðT ×5Ñ5ØØØØØØØó
ˆ	ñ Ü�M‰MðVô #Øõ
ð (ˆFàÐ&Ü—‘ð+ôð ×AÑAØà×#Ñ#Ó%¨Ò1ñ $à×%Ñ%Ó'Ø-Ø /Ø!Ø-Ø'ØØ /Ø&;Ø ð Bó ‰Fð" ˆFä�x‰xØ�K‰K×$Ñ$ØØØØ)ØØð %ó ó	
ð 		
rS   c                ó|   — t        t        j                  | j                  j	                  ||||||¬«      «      «      S )zÊCreate an index, returning a handle to the indexing job.

        The job may already be complete when returned; callers must not assume
        the index exists until :meth:`Job.wait` returns.
        r  )r#   r&   r�   rt   Úcreate_index_asyncrø   s          rQ   r  zRemoteTable.create_index_async¤  sF   € ô Ü�H‰HØ—‘×.Ñ.ØØ#Ø!Ø!-ØØð /ó ó	ó
ð 	
rS   ÚdataÚmodeÚon_bad_vectorsÚ
fill_valueÚprogressÚwrite_parallelismÚ!allow_external_blob_outside_basesc                 óà   — t        |«      \  }}	 t        j                  | j                  j	                  |||||||¬«      «      |r|j                  «        S S # |r|j                  «        w w xY w)aC  Add more data to the [Table][lancedb.table.Table].

        It has the same API signature as the OSS version.

        Parameters
        ----------
        data: DATA
            The data to insert into the table. Acceptable types are:

            - dict or list-of-dict

            - pandas.DataFrame

            - pyarrow.Table or pyarrow.RecordBatch
        mode: str
            The mode to use when writing the data. Valid values are
            "append" and "overwrite".
        on_bad_vectors: str, default "error"
            What to do if any of the vectors are not the same size or contains NaNs.
            One of "error", "drop", "fill".
        fill_value: float, default 0.
            The value to use when filling vectors. Only used if on_bad_vectors="fill".
        progress: bool, callable, or tqdm-like, optional
            A callback or tqdm-compatible progress bar. See
            :meth:`Table.add` for details.
        write_parallelism: int, optional
            Number of partitions to write in parallel. Higher values increase
            throughput but also peak memory use, since each partition buffers
            data in flight. Defaults to an estimate based on the data size,
            capped at the number of CPU cores. Lower this if bulk ingestion is
            using too much memory.
        allow_external_blob_outside_bases: bool, default False
            Not supported for remote tables. Setting this raises.

        Returns
        -------
        AddResult
            An object containing the new version number of the table after adding data.
        )r!  r"  r#  r$  r%  r&  )r/   r&   r�   rt   ÚaddÚclose)	rM   r   r!  r"  r#  r$  r%  r&  Úownss	            rQ   r(  zRemoteTable.addÀ  su   € ôb -¨XÓ6‰ˆ�$ð	!Ü—8‘8Ø—‘—‘ØØØ#1Ø)Ø%Ø&7Ø6Wð  ó ó
ñ Ø—‘Õ ð ø‰tØ—‘Õ ð ús   �4A ÁA-Úordering_field_nameÚfts_columnsÚfast_searchc           	      óà   — t        |t        «      rd}n#|dk(  rt        |t        «      r| j                  sd}t	        | j
                  |||¬«      }t        j                  | |||||xs g |¬«      S )az  Create a search query to find the nearest neighbors
        of the given query vector. We currently support
        [vector search](https://lancedb.com/docs/search/vector-search/)

        All query options are defined in
        [LanceVectorQueryBuilder][lancedb.query.LanceVectorQueryBuilder].

        Examples
        --------
        >>> import lancedb
        >>> db = lancedb.connect("db://...", api_key="...", # doctest: +SKIP
        ...                      region="...") # doctest: +SKIP
        >>> data = [
        ...    {"original_width": 100, "caption": "bar", "vector": [0.1, 2.3, 4.5]},
        ...    {"original_width": 2000, "caption": "foo",  "vector": [0.5, 3.4, 1.3]},
        ...    {"original_width": 3000, "caption": "test", "vector": [0.3, 6.2, 2.6]}
        ... ]
        >>> table = db.create_table("my_table", data) # doctest: +SKIP
        >>> query = [0.4, 1.4, 2.4]
        >>> (table.search(query) # doctest: +SKIP
        ...     .where("original_width > 1000", prefilter=True) # doctest: +SKIP
        ...     .select(["caption", "original_width"]) # doctest: +SKIP
        ...     .limit(2) # doctest: +SKIP
        ...     .to_pandas()) # doctest: +SKIP
          caption  original_width           vector  _distance # doctest: +SKIP
        0     foo            2000  [0.5, 3.4, 1.3]   5.220000 # doctest: +SKIP
        1    test            3000  [0.3, 6.2, 2.6]  23.089996 # doctest: +SKIP

        Parameters
        ----------
        query: list/np.ndarray/str/PIL.Image.Image, default None
            The targeted vector to search for.

            - *default None*.
            Acceptable types are: list, np.ndarray, PIL.Image.Image

        vector_column_name: str, optional
            The name of the vector column to search.

            - If not specified then the vector column is inferred from
            the table schema

            - If the table has multiple vector columns then the *vector_column_name*
            needs to be specified. Otherwise, an error is raised.

        query_type: str, default "auto"
            The type of search: "auto", "vector", "fts", or "hybrid".
            With "auto", a string query uses the embedding function for the
            inferred or specified vector column if available, otherwise it uses
            full-text search.

        fast_search: bool, optional
            Skip a flat search of unindexed data. This may improve
            search performance but search results will not include unindexed data.

            - *default None*, which leaves fast search disabled.

        Returns
        -------
        LanceQueryBuilder
            A query builder object representing the query.
            Once executed, the query returns

            - selected columns

            - the vector

            - and also the "_distance" column which is the distance between the query
            vector and the returned vector.
        ÚftsÚauto)r–   Ú
query_typerÄ   r  )r  r+  r,  r-  )rð   r3   rñ   r¦   r@   r–   r4   Úcreate)rM   rÄ   r  r1  r+  r,  r-  s          rQ   ÚsearchzRemoteTable.search  s~   € ô^ �eœ]Ô+Ø‰Jà˜&Ò Ü˜5¤#Ô&Ø×,Ò,àˆJÜ5Ø—;‘;Ø!ØØ1ô	
Ðô !×'Ñ'ØØØØ1Ø 3Ø#Ò) rØ#ô
ð 	
rS   ©r´   Útimeoutr´   r5  c                óÎ   ‡— t        j                  | j                  j                  |||¬«      «      Šˆfd„}t        j
                  j                  ‰j                   |«       «      S )Nr4  c               3   óz   •K  — 	 	 t        j                  ‰ j                  «       «      –— Œ&# t        $ r Y y w xY w­wr_   )r&   r�   Ú	__anext__ÚStopAsyncIteration)Ú
async_iters   €rQ   Ú	iter_syncz-RemoteTable._execute_query.<locals>.iter_syncu  s=   øè ø€ ðØÜŸ(™( :×#7Ñ#7Ó#9Ó:Ò:ð øä%ò Ùðüs   ƒ;…', ¬	8µ;·8¸;)r&   r�   rt   Ú_execute_queryÚpaÚRecordBatchReaderÚfrom_batchesr–   )rM   rÄ   r´   r5  r;  r:  s        @rQ   r<  zRemoteTable._execute_queryj  sT   ø€ ô —X‘XØ�K‰K×&Ñ& u¸ÈWÐ&ÓUó
ˆ
ô	ô ×#Ñ#×0Ñ0°×1BÑ1BÁIÃKÓPÐPrS   Úverbosec                 ó`   — t        j                  | j                  j                  ||«      «      S r_   )r&   r�   rt   Ú_explain_plan)rM   rÄ   r@  s      rQ   rB  zRemoteTable._explain_plan~  s"   € Ü�x‰x˜Ÿ™×1Ñ1°%¸ÓAÓBÐBrS   Ú	aggregate©Údistributed_metricsrE  c                ób   — t        j                  | j                  j                  ||¬«      «      S )NrD  )r&   r�   rt   Ú_analyze_plan)rM   rÄ   rE  s      rQ   rG  zRemoteTable._analyze_plan�  s-   € ô �x‰xØ�K‰K×%Ñ% eÐATÐ%ÓUó
ð 	
rS   c                 ó^   — t        j                  | j                  j                  |«      «      S r_   )r&   r�   rt   Ú_output_schema)rM   rÄ   s     rQ   rI  zRemoteTable._output_schema‹  s    € Ü�x‰x˜Ÿ™×2Ñ2°5Ó9Ó:Ð:rS   Úonc                 ó"   •— t         ‰| �  |«      S )zìReturns a [`LanceMergeInsertBuilder`][lancedb.merge.LanceMergeInsertBuilder]
        that can be used to create a "merge insert" operation.

        See [`Table.merge_insert`][lancedb.table.Table.merge_insert] for more details.
        )ÚsuperÚmerge_insert)rM   rJ  Ú	__class__s     €rQ   rM  zRemoteTable.merge_insertŽ  s   ø€ ô ‰wÑ# BÓ'Ð'rS   ÚmergeÚnew_datac                 ód   — t        j                  | j                  j                  ||||«      «      S r_   )r&   r�   rt   Ú	_do_merge)rM   rO  rP  r"  r#  s        rQ   rR  zRemoteTable._do_merge–  s-   € ô �x‰xØ�K‰K×!Ñ! %¨°>À:ÓNó
ð 	
rS   Ú	predicateÚwherec                 ó^   — t        j                  | j                  j                  |«      «      S )aö  Delete rows from the table.

        This can be used to delete a single row, many rows, all rows, or
        sometimes no rows (if your predicate matches nothing).

        Parameters
        ----------
        where: Union[str, Expr]
            The SQL where clause to use when deleting rows.

            - For example, 'x = 2' or 'x IN (1, 2, 3)'.

            The filter must not be empty, or it will error.

        Returns
        -------
        DeleteResult
            An object containing the new version number of the table after deletion.

        Examples
        --------
        >>> import lancedb
        >>> data = [
        ...    {"x": 1, "vector": [1, 2]},
        ...    {"x": 2, "vector": [3, 4]},
        ...    {"x": 3, "vector": [5, 6]}
        ... ]
        >>> db = lancedb.connect("db://...", api_key="...", # doctest: +SKIP
        ...                      region="...") # doctest: +SKIP
        >>> table = db.create_table("my_table", data) # doctest: +SKIP
        >>> table.search([10,10]).to_pandas() # doctest: +SKIP
           x      vector  _distance # doctest: +SKIP
        0  3  [5.0, 6.0]       41.0 # doctest: +SKIP
        1  2  [3.0, 4.0]       85.0 # doctest: +SKIP
        2  1  [1.0, 2.0]      145.0 # doctest: +SKIP
        >>> table.delete("x = 2") # doctest: +SKIP
        >>> table.search([10,10]).to_pandas() # doctest: +SKIP
           x      vector  _distance # doctest: +SKIP
        0  3  [5.0, 6.0]       41.0 # doctest: +SKIP
        1  1  [1.0, 2.0]      145.0 # doctest: +SKIP

        If you have a list of values to delete, you can combine them into a
        stringified list and use the `IN` operator:

        >>> to_remove = [1, 3] # doctest: +SKIP
        >>> to_remove = ", ".join([str(v) for v in to_remove]) # doctest: +SKIP
        >>> table.delete(f"x IN ({to_remove})") # doctest: +SKIP
        >>> table.search([10,10]).to_pandas() # doctest: +SKIP
           x      vector  _distance # doctest: +SKIP
        0  2  [3.0, 4.0]       85.0 # doctest: +SKIP
        )r&   r�   rt   Údelete)rM   rT  s     rQ   rV  zRemoteTable.delete¡  s#   € ôj �x‰x˜Ÿ™×*Ñ*¨5Ó1Ó2Ð2rS   )Ú
values_sqlÚvaluesrW  c                ód   — t        j                  | j                  j                  |||¬«      «      S )aÈ  
        This can be used to update zero to all rows depending on how many
        rows match the where clause.

        Parameters
        ----------
        where: str or [Expr][lancedb.expr.Expr], optional
            The filter condition. Can be a SQL string or a type-safe
            [Expr][lancedb.expr.Expr] built with [col][lancedb.expr.col] and
            [lit][lancedb.expr.lit]. The filter must not be empty, or it will
            error.
        values: dict, optional
            The values to update. The keys are the column names and the values
            are the values to set.
        values_sql: dict, optional
            The values to update, expressed as SQL expression strings. These can
            reference existing columns. For example, {"x": "x + 1"} will increment
            the x column by 1.

        Returns
        -------
        UpdateResult
            - rows_updated: The number of rows that were updated
            - version: The new version number of the table after the update

        Examples
        --------
        >>> import lancedb
        >>> data = [
        ...    {"x": 1, "vector": [1, 2]},
        ...    {"x": 2, "vector": [3, 4]},
        ...    {"x": 3, "vector": [5, 6]}
        ... ]
        >>> db = lancedb.connect("db://...", api_key="...", # doctest: +SKIP
        ...                      region="...") # doctest: +SKIP
        >>> table = db.create_table("my_table", data) # doctest: +SKIP
        >>> table.to_pandas() # doctest: +SKIP
           x      vector # doctest: +SKIP
        0  1  [1.0, 2.0] # doctest: +SKIP
        1  2  [3.0, 4.0] # doctest: +SKIP
        2  3  [5.0, 6.0] # doctest: +SKIP
        >>> table.update(where="x = 2", values={"vector": [10, 10]}) # doctest: +SKIP
        >>> table.to_pandas() # doctest: +SKIP
           x        vector # doctest: +SKIP
        0  1    [1.0, 2.0] # doctest: +SKIP
        1  3    [5.0, 6.0] # doctest: +SKIP
        2  2  [10.0, 10.0] # doctest: +SKIP

        )rT  ÚupdatesÚupdates_sql)r&   r�   rt   Úupdate)rM   rT  rX  rW  s       rQ   r\  zRemoteTable.updateØ  s/   € ôp �x‰xØ�K‰K×Ñ U°FÈ
ÐÓSó
ð 	
rS   )Údelete_unverifiedÚ
older_thanr]  c                ó2   — t        j                  dd¬«       y)zF
        cleanup_old_versions() is a no-op for remote tables.
        z4cleanup_old_versions() is a no-op for remote tables.r0   rF   N©rI   rJ   )rM   r^  r]  s      rQ   Úcleanup_old_versionsz RemoteTable.cleanup_old_versions  s   € ô 	�‰ØBØõ	
ð 	rS   c                 ó2   — t        j                  dd¬«       y)z?
        compact_files() is a no-op for remote tables.
        z-compact_files() is a no-op for remote tables.r0   rF   Nr`  )rM   rN   rO   s      rQ   Úcompact_fileszRemoteTable.compact_files#  s   € ô 	�‰Ø;Øõ	
ð 	rS   )Úcleanup_older_thanr]  ÚretrainÚcompaction_optionsrd  re  rf  c                ód   — t        j                  | j                  j                  |||¬«      «      S )z.optimize() is not supported for remote tables.)rd  r]  re  )r&   r�   rt   Úoptimize)rM   rd  r]  re  rf  s        rQ   rh  zRemoteTable.optimize-  s5   € ô �x‰xØ�K‰K× Ñ Ø#5Ø"3Øð !ó ó
ð 	
rS   Úfilterc                 ó^   — t        j                  | j                  j                  |«      «      S r_   )r&   r�   rt   Ú
count_rows)rM   ri  s     rQ   rk  zRemoteTable.count_rows>  s    € Ü�x‰x˜Ÿ™×.Ñ.¨vÓ6Ó7Ð7rS   ©ÚcomputedÚauto_refresh_enabledÚauto_refresh_interval_secondsÚ
transformsrm  rn  ro  c                óf   — t        j                  | j                  j                  ||||¬«      «      S )Nrl  )r&   r�   rt   Úadd_columns)rM   rp  rm  rn  ro  s        rQ   rr  zRemoteTable.add_columnsA  s8   € ô �x‰xØ�K‰K×#Ñ#ØØ!Ø%9Ø.Kð	 $ó ó
ð 	
rS   c                 ó^   — t        j                  | j                  j                  |«      «      S r_   )r&   r�   rt   Úrefresh_column©rM   rÂ   s     rQ   rt  zRemoteTable.refresh_columnW  s    € Ü�x‰x˜Ÿ™×2Ñ2°6Ó:Ó;Ð;rS   c                 óp   — t        t        j                  | j                  j	                  |«      «      «      S r_   )r#   r&   r�   rt   Úrefresh_column_asyncru  s     rQ   rw  z RemoteTable.refresh_column_asyncZ  s%   € Ü”4—8‘8˜DŸK™K×<Ñ<¸VÓDÓEÓFÐFrS   Újob_idÚlimitc                 ód   — t        j                  | j                  j                  |||¬«      «      S )N)rx  rÂ   ry  )r&   r�   rt   Úfunction_errors)rM   rx  rÂ   ry  s       rQ   r{  zRemoteTable.function_errors]  s.   € ô �x‰xØ�K‰K×'Ñ'¨v¸fÈEÐ'ÓRó
ð 	
rS   Úalterationsc                 óZ   — t        j                   | j                  j                  |Ž «      S r_   )r&   r�   rt   Úalter_columns)rM   r|  s     rQ   r~  zRemoteTable.alter_columnsg  s%   € ô �x‰xÐ1˜Ÿ™×1Ñ1°;Ð?Ó@Ð@rS   rZ  c                 óZ   — t        j                   | j                  j                  |Ž «      S r_   )r&   r�   rt   Úupdate_field_metadata)rM   rZ  s     rQ   r€  z!RemoteTable.update_field_metadatal  s%   € ô �x‰xÐ9˜Ÿ™×9Ñ9¸7ÐCÓDÐDrS   Úcolumnsc                 ó^   — t        j                  | j                  j                  |«      «      S r_   )r&   r�   rt   Údrop_columns©rM   r�  s     rQ   rƒ  zRemoteTable.drop_columnsq  s    € Ü�x‰x˜Ÿ™×0Ñ0°Ó9Ó:Ð:rS   c                 ó^   — t        j                  | j                  j                  |«      «      S )zASet the unenforced primary key for this table to a single column.)r&   r�   rt   Úset_unenforced_primary_keyr„  s     rQ   r†  z&RemoteTable.set_unenforced_primary_keyt  s    € ä�x‰x˜Ÿ™×>Ñ>¸wÓGÓHÐHrS   r   c                 ó^   — t        j                  | j                  j                  |«      «      S )zInstall an RTEWriteSpec.)r&   r�   rt   Ú
enable_rte)rM   Úspecs     rQ   rˆ  zRemoteTable.enable_rtex  ó    € ä�x‰x˜Ÿ™×.Ñ.¨tÓ4Ó5Ð5rS   c                 ó\   — t        j                  | j                  j                  «       «      S )zRemove the RTEWriteSpec.)r&   r�   rt   Údisable_rterp   s    rQ   rŒ  zRemoteTable.disable_rte|  s   € ä�x‰x˜Ÿ™×/Ñ/Ó1Ó2Ð2rS   c                 ó\   — t        j                  | j                  j                  «       «      S )z-Read the installed RTEWriteSpec, or ``None``.)r&   r�   rt   Úget_rte_specrp   s    rQ   rŽ  zRemoteTable.get_rte_spec€  rÀ   rS   c                 ó6   — | j                   j                  «       S r_   )rt   Ú_hybrid_pk_fusion_learnedrp   s    rQ   r�  z%RemoteTable._hybrid_pk_fusion_learned…  s   € à�{‰{×4Ñ4Ó6Ð6rS   c                 ó8   — | j                   j                  «        y r_   )rt   Ú_note_hybrid_pk_fusionrp   s    rQ   r’  z"RemoteTable._note_hybrid_pk_fusion‰  s   € Ø�‰×*Ñ*Õ,rS   c                 ó\   — t        j                  | j                  j                  «       «      S )z`Synchronous version of
        [`AsyncTable.checkpoint_rte`][lancedb.AsyncTable.checkpoint_rte].)r&   r�   rt   Úcheckpoint_rterp   s    rQ   r”  zRemoteTable.checkpoint_rteŒ  s    € ô �x‰x˜Ÿ™×2Ñ2Ó4Ó5Ð5rS   c                 ó\   — t        j                  | j                  j                  «       «      S )zVSynchronous version of
        [`AsyncTable.flush_rte`][lancedb.AsyncTable.flush_rte].)r&   r�   rt   Ú	flush_rterp   s    rQ   r–  zRemoteTable.flush_rte‘  s    € ô �x‰x˜Ÿ™×-Ñ-Ó/Ó0Ð0rS   c                 ó\   — t        j                  | j                  j                  «       «      S )zZSynchronous version of
        [`AsyncTable.compact_rte`][lancedb.AsyncTable.compact_rte].)r&   r�   rt   Úcompact_rterp   s    rQ   r˜  zRemoteTable.compact_rte–  s    € ô �x‰x˜Ÿ™×/Ñ/Ó1Ó2Ð2rS   ©Úinclude_sstable_rowsrš  c                ó`   — t        j                  | j                  j                  |¬«      «      S )z^Synchronous version of
        [`AsyncTable.get_rte_stats`][lancedb.AsyncTable.get_rte_stats].r™  )r&   r�   rt   Úget_rte_stats)rM   rš  s     rQ   rœ  zRemoteTable.get_rte_stats›  s+   € ô �x‰xØ�K‰K×%Ñ%Ð;OÐ%ÓPó
ð 	
rS   c                 ó\   — t        j                  | j                  j                  «       «      S )z1No-op for remote tables (no local shard writers).)r&   r�   rt   Úclose_rte_writersrp   s    rQ   rž  zRemoteTable.close_rte_writers¢  s   € ä�x‰x˜Ÿ™×5Ñ5Ó7Ó8Ð8rS   c                 ó^   — t        j                  | j                  j                  |«      «      S r_   )r&   r�   rt   Ú
drop_index©rM   ra   s     rQ   r   zRemoteTable.drop_index¦  rŠ  rS   c                 ó^   — t        j                  | j                  j                  |«      «      S )aý  Prewarm an index in the table.

        This is a hint to the database that the index will be accessed in the
        future and should be loaded into memory if possible.  This can reduce
        cold-start latency for subsequent queries.

        This call initiates prewarming and returns once the request is accepted.
        It is idempotent and safe to call from multiple clients concurrently.

        Parameters
        ----------
        name: str
            The name of the index to prewarm
        )r&   r�   rt   Úprewarm_indexr¡  s     rQ   r£  zRemoteTable.prewarm_indexª  s"   € ô �x‰x˜Ÿ™×1Ñ1°$Ó7Ó8Ð8rS   c                 ó^   — t        j                  | j                  j                  |«      «      S )ae  Prewarm data for the table.

        This is a hint to the database that the given columns will be accessed
        in the future and the database should prefetch the data if possible.
        Currently only supported on remote tables.

        This call initiates prewarming and returns once the request is accepted.
        It is idempotent and safe to call from multiple clients concurrently.

        This operation has a large upfront cost but can speed up future queries
        that need to fetch the given columns.  Large columns such as embeddings
        or binary data may not be practical to prewarm.  This feature is intended
        for workloads that issue many queries against the same columns.

        Parameters
        ----------
        columns: list of str, optional
            The columns to prewarm. If None, all columns are prewarmed.
        )r&   r�   rt   Úprewarm_datar„  s     rQ   r¥  zRemoteTable.prewarm_data»  s"   € ô( �x‰x˜Ÿ™×0Ñ0°Ó9Ó:Ð:rS   )ÚsecondsÚindex_namesc                 ó`   — t        j                  | j                  j                  ||«      «      S r_   )r&   r�   rt   Úwait_for_index)rM   r§  r5  s      rQ   r©  zRemoteTable.wait_for_indexÑ  s$   € ô �x‰x˜Ÿ™×2Ñ2°;ÀÓHÓIÐIrS   c                 ó\   — t        j                  | j                  j                  «       «      S r_   )r&   r�   rt   Ústatsrp   s    rQ   r«  zRemoteTable.statsÖ  s   € Ü�x‰x˜Ÿ™×)Ñ)Ó+Ó,Ð,rS   c                 ó\   — t        j                  | j                  j                  «       «      S )z~The table URI (storage location).

        For remote tables, this fetches the location from the server via describe.
        )r&   r�   rt   Úurirp   s    rQ   r­  zRemoteTable.uriÙ  s   € ô �x‰x˜Ÿ™Ÿ™Ó)Ó*Ð*rS   )Úwith_row_idÚoffsetsr®  c                ór   — t        | j                  j                  |«      «      }|r|j                  «        |S r_   )r5   rt   Útake_offsetsr®  )rM   r¯  r®  Úbuilders       rQ   r±  zRemoteTable.take_offsetsá  ó1   € ô (¨¯©×(@Ñ(@ÀÓ(IÓJˆÙØ×ÑÔ!ØˆrS   Úrow_idsc                ór   — t        | j                  j                  |«      «      }|r|j                  «        |S r_   )r5   rt   Útake_row_idsr®  )rM   r´  r®  r²  s       rQ   r¶  zRemoteTable.take_row_idsé  r³  rS   c                 ó\   — t        j                  | j                  j                  «       «      S r_   )r&   r�   rt   Úuses_v2_manifest_pathsrp   s    rQ   r¸  z"RemoteTable.uses_v2_manifest_pathsñ  s   € Ü�x‰x˜Ÿ™×:Ñ:Ó<Ó=Ð=rS   c                 ó\   — t        j                  | j                  j                  «       «      S r_   )r&   r�   rt   Úmigrate_manifest_paths_v2rp   s    rQ   Úmigrate_v2_manifest_pathsz%RemoteTable.migrate_v2_manifest_pathsô  s   € Ü�x‰x˜Ÿ™×=Ñ=Ó?Ó@Ð@rS   c                 ó\   — t        j                  | j                  j                  «       «      S r_   )r&   r�   rt   Úblob_columnsrp   s    rQ   r½  zRemoteTable.blob_columns÷  s   € Ü�x‰x˜Ÿ™×0Ñ0Ó2Ó3Ð3rS   c                 ó`   — t        j                  | j                  j                  ||«      «      S r_   )r&   r�   rt   Úfetch_blobs©rM   rÂ   r´  s      rQ   r¿  zRemoteTable.fetch_blobsú  s$   € ô
 �x‰x˜Ÿ™×/Ñ/°¸Ó@ÓAÐArS   c                 ór   — t        j                  | j                  j                  |t	        |«      «      «      S r_   )r&   r�   rt   Úfetch_blob_rangesrd   )rM   rÂ   Úrequestss      rQ   rÂ  zRemoteTable.fetch_blob_ranges  s&   € Ü�x‰x˜Ÿ™×5Ñ5°f¼dÀ8»nÓMÓNÐNrS   zlist[Optional[BlobFile]]c                 ó`   — t        j                  | j                  j                  ||«      «      S r_   )r&   r�   rt   Úfetch_blob_filesrÀ  s      rQ   rÅ  zRemoteTable.fetch_blob_files  s$   € ô
 �x‰x˜Ÿ™×4Ñ4°V¸WÓEÓFÐFrS   Ú
descriptorc                 ó^   — t        j                  | j                  j                  |«      «      S r_   )r&   r�   rt   Úopen_blob_file)rM   rÆ  s     rQ   rÈ  zRemoteTable.open_blob_file  s"   € ô �x‰x˜Ÿ™×2Ñ2°:Ó>Ó?Ð?rS   c                 ó–   — t        j                  | j                  j                  «       j	                  |«      j                  «       «      S )z¤
        Return the first `n` rows of the table.

        Parameters
        ----------
        n: int, default 5
            The number of rows to return.
        )r&   r�   rt   rÄ   ry  r®   )rM   Úns     rQ   ÚheadzRemoteTable.head  s4   € ô �x‰x˜Ÿ™×)Ñ)Ó+×1Ñ1°!Ó4×=Ñ=Ó?Ó@Ð@rS   )rl   Nr_   )r©   )rl   zlance.LanceDataset)rl   zpl.LazyFrame).............)ÚappendÚerrorg        NNF)NNr0  NNN)F)NN)NNN)r‰  r   rl   N)é   )—Ú__name__Ú
__module__Ú__qualname__r6   rñ   r   r   r   r   rk   rq   Úpropertyrt   Úsetterrs   Údictr�   r…   ra   rˆ   ÚdeprecationÚ
deprecatedr   r	   r�   r”   r=  ÚSchemar–   Úintrz   r=   r™   r8   r›   r�   r¡   r   r   r¦   r¨   r7   r<   r®   r°   r²   rµ   r·   r»   r½   r
   r   r¿   r   rÆ   rV   r:   rÉ   Úboolr?   r   rÕ   r2   ÚROWr>   rõ   r   r'   rÔ   r   r+   r#   r  r)   Úfloatr   r   r(  r*   r4   r3  r;   r>  r<  rB  r1   rG  rI  r-   rM  r   rR  r   r   rV  r   r\  ra  rc  r9   rh  rk  r$   ÚFieldr   rr  rt  r%   rw  r{  r   r~  r   r€  r   rƒ  r†  rˆ  rŒ  rŽ  r�  r’  r”  r–  r˜  rœ  rž  r   r£  r¥  r©  r«  r­  rd   r5   r±  r¶  r¸  r»  r½  ÚArrayÚChunkedArrayÚLargeBinaryArrayr¿  rÂ  rÅ  ÚStructScalarr   rÈ  rË  Ú__classcell__)rN  s   @rQ   rX   rX   j   sx  ø„ ð EIØ.2ò àð ð ð ð
 # 5¨¨h°r¸3°wÑ.?Ð)?Ñ#@ÑAð ð !  c¡Ñ+ó ð&&¨có &ð ð"˜
ò "ó ð"ð
 ‡]�]ð ˜Jð  ¨4ò  ó ð ó
ð.
˜dó 
ð $ð ¨4ó ð ð�cò ó ðð ð$˜4 ™9ò $ó ð$ð €[×ÑØØ#Ø6ôð
O°ð OÀDÈÈcÈÁNò Oóð
Oð:˜#ó :ð ð.˜Ÿ	™	ò .ó ð.ð ð/˜ò /ó ð/ð ð!�dò !ó ð!ð ð˜(ò ó ðð, ¨¡ó ,ð
 AEñØ%ðØ08¸±ðà	óð ð
 T¨#Ð/FÐ*FÑ%Gò 
ó ð
ò5ð 17ò 
 Xð 
¸2¿8¹8ó 
ñ
 8ó 
ó8ô
ð  c¨3 h¡ó ò
ñ
˜x¨¨c°3¨h©Ñ8ó ð
4˜h {Ñ3ó 4ð !%Ø$(ò
àð
ð ˜‘ð	
ð
 ˜S‘Mð
ð 
�(Ñ	ó
ñ* ˜ |Ó4ð= cð =¨h°Ñ.Gò =ó 5ð=ð €[×ÑØØ#ØVôð Ø&-Ø,0Ø"ò&
àð&
ð ð	&
ð
 $ð&
ð ˜yÑ)ð&
ð �s‰mò&
óð
&
ðP €[×ÑØØ#Ø?ôñ
 ˜ =Ó1ð
 AEØØ*<Ø!Ø(,Ø#à,4Ø!Ø*,ØØ#Ø,0Ø15Ø"Ø !Ø !Ø!ØØ4G×4KÑ4KØ,0Ø"ò3`à˜3  S¡	˜>Ñ*ð`ð ' u¨S°$°s±)¨^Ñ'<Ñ=ð	`ð
 ð`ð # 3™-ð`ð ð`ð ! ™ð`ð ð`ð *ð`ð ð`ð # 3™-ð`ð ð`ð �t‰nð`ð  $ D™>ð!`ð" $ D¨¡IÑ.ð#`ð$ ð%`ð& ð'`ð( ð)`ð* ð+`ð, ð-`ð. 2ð/`ð0 ˜yÑ)ð1`ð2 �s‰mò3`ó 2óð`ðF ð Ø,/Ø!Øò
àð
ð
  ð
ð ð
ð ˜yÑ)ð
ð �s‰mð
ð ð
ð 
ò
ó ð
ð ð =@Ø(+Ø),Ø"%ØØ%(Ø*-Øð Ø!ØØØ"ð!ð$ -0Ø!ØØ/2ò+àÐ8Ñ9ðð ! ™ðð " #™ð	ð
  ðð ðð ˜c‘]ðð # 3™-ðð ðð ØRñ
ðð ðð ðð ðð  ð!ð$ ˜yÑ)ð%ð& �s‰mð'ð( ð)ð*  (¨™}ð+ð, 
ò-ó ðð4 Ø(,Ø)-Ø"4ØØ%)Ø*.Øð Ø ØØØ"ð-G
ð0 -1Ø,0Ø"ØØ/3ò9G
àðG
ð ! ™ðG
ð " #™ð	G
ð
  ðG
ð ðG
ð ˜c‘]ðG
ð # 3™-ðG
ð ðG
ð ðñ
ðG
ð& ð'G
ð( ð)G
ð* ð+G
ð, ð-G
ð0 ˜Ñ)ð1G
ð2 ˜yÑ)ð3G
ð4 �s‰mð5G
ð6 ð7G
ð8  (¨™}ó9G
ð\ #'Ø,0Ø"Øò
àð
ð  ð	
ð
 ˜$‘ð
ð ˜yÑ)ð
ð �s‰mð
ð ð
ð 
ó
ð> Ø%ØØ9=Ø+/Ø27ñ@!àð@!ð ð@!ð ð	@!ð
 ð@!ð ˜5  x°Ð!4Ñ5Ñ6ð@!ð $ C™=ð@!ð ,0ð@!ð 
ó@!ðH "&Ø,0ØØ-1Ø7;Ø&*ñf
à�S˜#�X‰ðf
ð % S™Mðf
ð
 & c™]ðf
ð ˜e C¨¨c© NÑ3Ñ4ðf
ð ˜d‘^ðf
ð 
óf
ðX %)Ø'+òQàðQð ˜S‘Mð	Qð
 ˜)Ñ$ðQð 
×	Ñ	óQñ(C 5ð C°8¸D±>ð CÈcó Cð >Iò	
àð
ð ;ð	
ð
 
ó
ð; Eð ;¨b¯i©ió ;ð(˜u S¨(°3©-Ð%7Ñ8ð (Ð=Tõ (ð	
à&ð	
ð ð	
ð ð		
ð
 ð	
ð 
ó	
ñ ˜ gÓ.ð43˜E # t )Ñ,ð 43°ò 43ó /ð43ðp -1Ø!%ð:
ð
 04ò:
à˜˜c 4˜iÑ(Ñ)ð:
ð ˜‘ð:
ð
 ˜T # s (™^Ñ,ð:
ð 
ó:
ð| +/ðð #(ò	à˜YÑ'ðð  ó	òð 37Ø"'ØØ:>ò
ð % YÑ/ð
ð  ð	
ð
 ð
ð %Ð%6Ñ7ó
ñ"8 ¨#¡ð 8¸#ó 8ð ð
ð +/Ø,0Ø48ò
à˜˜cÐ$7Ñ7Ð7Ñ8Ø
ñà
�(‰(ñð ˆr�x‰x‰.ñð �)‰)ñ	ð
 ñð
ð �s˜C�x‘. 4Ñ'ð
ð # T™kð
ð (+¨T¡zð
ð 
ó
ð,< Só <ðG¨3ð G°3Ð7JÑ3Kó Gð
 !%Ø $Ø#ñ	
à˜‘ð
ð ˜‘ð
ð ˜‰}ó	
ðAØ$ T¨#¨s¨(¡^Ñ4ðAà	óAð
EØ˜S #˜X™ðEà	"óEð
; H¨S¡Mð ;Ð6Gó ;ðI°%¸¸XÀc¹]Ð8JÑ2Kð IÐPTó Ió6ó3ð4˜h ~Ñ6ó 4ð
7¨4ó 7ó-ó6ó
1ó
3ð
 =Bò 
°Tð 
ÀhÈtÁnó 
ó9ñ ˜ vÓ.ð6˜sð 6 tò 6ó /ð6ð9 #ð 9¨$ó 9ñ"; H¨T°#©YÑ$7ð ;À4ó ;ñ. @IÐQTÔ?UñJØ# C™=ðJØ3<óJò
-ð ð+�Sò +ó ð+ð :?òØ˜C‘yðØ26ðà	óð :?òØ˜C‘yðØ26ðà	óð>¨ó >òAð4˜d 3™ió 4ðBàðBð �t˜C‘y "§(¢(¨B¯OªO¸R¿X¹XÐEÑFðBð 
×	Ò	ó	BðO¨ð O¸"×:MÒ:Mó OðGàðGð �t˜C‘y "§(¢(¨B¯OªO¸R¿X¹XÐEÑFðGð 
$ó	Gð@Ø  b§o¢o°tÐ ;Ñ<ð@à	�(Ñ	ó@ñ
	A˜2Ÿ8™8÷ 	ArS   rX   ÚtblÚirl   c           
      óÚ   — | j                  dt        j                  dt        j                  «       «      t        j                  |gt        | «      z  t        j                  «       «      «      S )Nr   Úquery_index)Ú
add_columnr=  ÚfieldÚuint32ÚarrayÚlen)râ  rã  s     rQ   Ú	add_indexrë    sH   € Ø�>‰>Ø	Ü
�‰�¤§	¡	£Ó,Ü
�‰�!�”s˜3“x‘¤§¡£Ó-óð rS   )_Údatetimer   rÕ  r  Ú	functoolsr   r   rh   Útypingr   r   r   r	   r
   r   r   r   r   r   rI   r{   r   Úlancedb._blobr   Úlancedb._lancedbr   r   r   r   r   r   r   r   r   r   r   Úlancedb.embeddings.baser   Úlancedb.exprr   Úlancedb.indexr   r    r!   r"   Úlancedb.jobr#   Úlancedb.functionsr$   r%   Úlancedb.remote.dbr&   Úlancedb.tabler'   r(   Úpyarrowr=  Úlancedb.commonr)   r*   r+   r,   Úlancedb.merger-   Úlancedb.embeddingsr.   r/   rÄ   r1   r2   r3   r4   r5   r\   r6   r7   r8   r9   r:   r;   r<   r=   Útypesr>   r?   Úutilr@   ÚlanceÚpolarsÚplrñ   rV   rX   rØ  rë  rU   rS   rQ   ú<module>r     sé   ðõ Û Û ß ,Û 	÷÷ ÷ ó å Ý "÷÷ ÷ ñ õ <Ý ÷ó õ ß FÝ "ß DÛ ç 8Ñ 8Ý ,Ý 1Ý 8Ý -÷õ ÷	÷ 	ó 	÷ 7Ý +áÛÛð #ð °ó ô,oA�%ô oAðd%�2—8‘8ð  ð ¨¯©ô rS   