original_docstring: Start a partitioned batch read operation.
  
          Uses the ``PartitionRead`` API request to initiate the partitioned
          read.  Returns a list of batch information needed to perform the
          actual reads.
  
          :type table: str
          :param table: name of the table from which to fetch data
  
          :type columns: list of str
          :param columns: names of columns to be retrieved
  
          :type keyset: :class:`~google.cloud.spanner_v1.keyset.KeySet`
          :param keyset: keys / ranges identifying rows to be retrieved
  
          :type index: str
          :param index: (Optional) name of index to use, rather than the
                        table's primary key
  
          :type partition_size_bytes: int
          :param partition_size_bytes:
              (Optional) desired size for each partition generated.  The service
              uses this as a hint, the actual partition size may differ.
  
          :type max_partitions: int
          :param max_partitions:
              (Optional) desired maximum number of partitions generated. The
              service uses this as a hint, the actual number of partitions may
              differ.
  
          :type retry: :class:`~google.api_core.retry.Retry`
          :param retry: (Optional) The retry settings for this request.
  
          :type timeout: float
          :param timeout: (Optional) The timeout for this request.
  
          :rtype: iterable of dict
          :returns:
              mappings of information used perform actual partitioned reads via
              :meth:`process_read_batch`.
          
docstring: Start a partitioned batch read operation.
  Uses the ``PartitionRead`` API request to initiate the partitioned
  read.  Returns a list of batch information needed to perform the
  actual reads.
docstring_tokens: Start a partitioned batch read operation . Uses the ` ` PartitionRead ` ` API request to initiate the partitioned read . Returns a list of batch information needed to perform the actual reads .
code: def generate_read_batches(
          self,
          table,
          columns,
          keyset,
          index="",
          partition_size_bytes=None,
          max_partitions=None,
          *,
          retry=gapic_v1.method.DEFAULT,
          timeout=gapic_v1.method.DEFAULT,
      ):
          """Start a partitioned batch read operation.
  
          Uses the ``PartitionRead`` API request to initiate the partitioned
          read.  Returns a list of batch information needed to perform the
          actual reads.
  
          :type table: str
          :param table: name of the table from which to fetch data
  
          :type columns: list of str
          :param columns: names of columns to be retrieved
  
          :type keyset: :class:`~google.cloud.spanner_v1.keyset.KeySet`
          :param keyset: keys / ranges identifying rows to be retrieved
  
          :type index: str
          :param index: (Optional) name of index to use, rather than the
                        table's primary key
  
          :type partition_size_bytes: int
          :param partition_size_bytes:
              (Optional) desired size for each partition generated.  The service
              uses this as a hint, the actual partition size may differ.
  
          :type max_partitions: int
          :param max_partitions:
              (Optional) desired maximum number of partitions generated. The
              service uses this as a hint, the actual number of partitions may
              differ.
  
          :type retry: :class:`~google.api_core.retry.Retry`
          :param retry: (Optional) The retry settings for this request.
  
          :type timeout: float
          :param timeout: (Optional) The timeout for this request.
  
          :rtype: iterable of dict
          :returns:
              mappings of information used perform actual partitioned reads via
              :meth:`process_read_batch`.
          """
          partitions = self._get_snapshot().partition_read(
              table=table,
              columns=columns,
              keyset=keyset,
              index=index,
              partition_size_bytes=partition_size_bytes,
              max_partitions=max_partitions,
              retry=retry,
              timeout=timeout,
          )
  
          read_info = {
              "table": table,
              "columns": columns,
              "keyset": keyset._to_dict(),
              "index": index,
          }
          for partition in partitions:
              yield {"partition": partition, "read": read_info.copy()}
code_tokens: def generate_read_batches ( self , table , columns , keyset , index = "" , partition_size_bytes = None , max_partitions = None , * , retry = gapic_v1 . method . DEFAULT , timeout = gapic_v1 . method . DEFAULT , ) : partitions = self . _get_snapshot ( ) . partition_read ( table = table , columns = columns , keyset = keyset , index = index , partition_size_bytes = partition_size_bytes , max_partitions = max_partitions , retry = retry , timeout = timeout , ) read_info = { "table" : table , "columns" : columns , "keyset" : keyset . _to_dict ( ) , "index" : index , } for partition in partitions : yield { "partition" : partition , "read" : read_info . copy ( ) }
short_docstring: Start a partitioned batch read operation.
short_docstring_tokens: Start a partitioned batch read operation .
comment: """Start a partitioned batch read operation.
  
          Uses the ``PartitionRead`` API request to initiate the partitioned
          read.  Returns a list of batch information needed to perform the
          actual reads.
  
          :type table: str
          :param table: name of the table from which to fetch data
  
          :type columns: list of str
          :param columns: names of columns to be retrieved
  
          :type keyset: :class:`~google.cloud.spanner_v1.keyset.KeySet`
          :param keyset: keys / ranges identifying rows to be retrieved
  
          :type index: str
          :param index: (Optional) name of index to use, rather than the
                        table's primary key
  
          :type partition_size_bytes: int
          :param partition_size_bytes:
              (Optional) desired size for each partition generated.  The service
              uses this as a hint, the actual partition size may differ.
  
          :type max_partitions: int
          :param max_partitions:
              (Optional) desired maximum number of partitions generated. The
              service uses this as a hint, the actual number of partitions may
              differ.
  
          :type retry: :class:`~google.api_core.retry.Retry`
          :param retry: (Optional) The retry settings for this request.
  
          :type timeout: float
          :param timeout: (Optional) The timeout for this request.
  
          :rtype: iterable of dict
          :returns:
              mappings of information used perform actual partitioned reads via
              :meth:`process_read_batch`.
          """