> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kinetica.com/llms.txt
> Use this file to discover all available pages before exploring further.

# getRecordsBySeries

<div className="kinetica-javadoc">
  <ul className="member-list">
    <li>
      <div className="section detail" id="getRecordsBySeries(java.lang.Object,com.gpudb.protocol.GetRecordsBySeriesRequest)">
        <h3>getRecordsBySeries</h3>
        <div className="member-signature"><span className="modifiers">public</span> <span className="type-parameters">\<TResponse></span> <span className="return-type"><a href="/content/api/java/com/gpudb/protocol/GetRecordsBySeriesResponse" title="class in com.gpudb.protocol">GetRecordsBySeriesResponse</a>\<TResponse></span> <span className="element-name">getRecordsBySeries</span><wbr /><span className="parameters">(<a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/Object.html" title="class or interface in java.lang" className="external-link">Object</a> typeDescriptor, <a href="/content/api/java/com/gpudb/protocol/GetRecordsBySeriesRequest" title="class in com.gpudb.protocol">GetRecordsBySeriesRequest</a> request)</span> throws <span className="exceptions"><a href="/content/api/java/com/gpudb/GPUdbException" title="class in com.gpudb">GPUdbException</a></span></div>

        <div className="block">
          Retrieves the complete series/track records from the given <a href="/content/api/java/com/gpudb/protocol/GetRecordsBySeriesRequest#getWorldTableName()"><code>worldTableName</code></a> based on the partial track information contained in the <a href="/content/api/java/com/gpudb/protocol/GetRecordsBySeriesRequest#getTableName()"><code>tableName</code></a>.
          <p> This operation supports paging through the data via the <a href="/content/api/java/com/gpudb/protocol/GetRecordsBySeriesRequest#getOffset()"><code>offset</code></a> and <a href="/content/api/java/com/gpudb/protocol/GetRecordsBySeriesRequest#getLimit()"><code>limit</code></a> parameters. </p>
          <p> In contrast to <a href="#getRecords(java.lang.Object,com.gpudb.protocol.GetRecordsRequest)"><code>getRecords</code></a> this returns records grouped by series/track. So if <a href="/content/api/java/com/gpudb/protocol/GetRecordsBySeriesRequest#getOffset()"><code>offset</code></a> is 0 and <a href="/content/api/java/com/gpudb/protocol/GetRecordsBySeriesRequest#getLimit()"><code>limit</code></a> is 5 this operation would return the first 5 series/tracks in <a href="/content/api/java/com/gpudb/protocol/GetRecordsBySeriesRequest#getTableName()"><code>tableName</code></a>. Each series/track will be returned sorted by their TIMESTAMP column.</p>
        </div>

        <div className="dl notes">
          <div className="dt">Type Parameters:</div>
          <div className="dd"><code>TResponse</code> - The type of object being retrieved.</div>
          <div className="dt">Parameters:</div>
          <div className="dd"><code>typeDescriptor</code> - Type descriptor used for decoding returned objects.</div>
          <div className="dd"><code>request</code> - <a href="/content/api/java/com/gpudb/protocol/GetRecordsBySeriesRequest" title="class in com.gpudb.protocol"><code>Request</code></a> object containing the parameters for the operation.</div>
          <div className="dt">Returns:</div>
          <div className="dd"><a href="/content/api/java/com/gpudb/protocol/GetRecordsBySeriesResponse" title="class in com.gpudb.protocol"><code>Response</code></a> object containing the results of the operation.</div>
          <div className="dt">Throws:</div>
          <div className="dd"><code><a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/IllegalArgumentException.html" title="class or interface in java.lang" className="external-link">IllegalArgumentException</a></code> - if <code>typeDescriptor</code> is not an instance of one of the following: <a href="/content/api/java/com/gpudb/Type" title="class in com.gpudb"><code>Type</code></a>, <a href="/content/api/java/com/gpudb/TypeObjectMap" title="class in com.gpudb"><code>TypeObjectMap</code></a>, <code>Schema</code>, or a <a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/Class.html" title="class or interface in java.lang" className="external-link"><code>Class</code></a> that implements <code>IndexedRecord</code></div>
          <div className="dd"><code><a href="/content/api/java/com/gpudb/GPUdbException" title="class in com.gpudb">GPUdbException</a></code> - if an error occurs during the operation.</div>
        </div>
      </div>
    </li>

    <li>
      <div className="section detail" id="getRecordsBySeries(java.lang.Object,java.lang.String,java.lang.String,int,int,java.util.Map)">
        <h3>getRecordsBySeries</h3>
        <div className="member-signature"><span className="modifiers">public</span> <span className="type-parameters">\<TResponse></span> <span className="return-type"><a href="/content/api/java/com/gpudb/protocol/GetRecordsBySeriesResponse" title="class in com.gpudb.protocol">GetRecordsBySeriesResponse</a>\<TResponse></span> <span className="element-name">getRecordsBySeries</span><wbr /><span className="parameters">(<a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/Object.html" title="class or interface in java.lang" className="external-link">Object</a> typeDescriptor, <a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/String.html" title="class or interface in java.lang" className="external-link">String</a> tableName, <a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/String.html" title="class or interface in java.lang" className="external-link">String</a> worldTableName, int offset, int limit, <a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/util/Map.html" title="class or interface in java.util" className="external-link">Map</a>\<<a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/String.html" title="class or interface in java.lang" className="external-link">String</a>,<wbr /><a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/String.html" title="class or interface in java.lang" className="external-link">String</a>> options)</span> throws <span className="exceptions"><a href="/content/api/java/com/gpudb/GPUdbException" title="class in com.gpudb">GPUdbException</a></span></div>

        <div className="block">
          Retrieves the complete series/track records from the given <code> worldTableName</code> based on the partial track information contained in the <code>tableName</code>.
          <p> This operation supports paging through the data via the <code>offset</code> and <code>limit</code> parameters. </p>
          <p> In contrast to <a href="#getRecords(java.lang.Object,java.lang.String,long,long,java.util.Map)"><code>getRecords</code></a> this returns records grouped by series/track. So if <code> offset</code> is 0 and <code>limit</code> is 5 this operation would return the first 5 series/tracks in <code>tableName</code>. Each series/track will be returned sorted by their TIMESTAMP column.</p>
        </div>

        <div className="dl notes">
          <div className="dt">Type Parameters:</div>
          <div className="dd"><code>TResponse</code> - The type of object being retrieved.</div>
          <div className="dt">Parameters:</div>
          <div className="dd"><code>typeDescriptor</code> - Type descriptor used for decoding returned objects.</div>
          <div className="dd"><code>tableName</code> - Name of the table or view for which series/tracks will be fetched, in \[schema\_name.]table\_name format, using standard <a href="/content/concepts/tables/#table-name-resolution" target="_top">name resolution rules</a>.</div>
          <div className="dd"><code>worldTableName</code> - Name of the table containing the complete series/track information to be returned for the tracks present in the <code>tableName</code>, in \[schema\_name.]table\_name format, using standard <a href="/content/concepts/tables/#table-name-resolution" target="_top">name resolution rules</a>. Typically this is used when retrieving series/tracks from a view (which contains partial series/tracks) but the user wants to retrieve the entire original series/tracks. Can be blank.</div>
          <div className="dd"><code>offset</code> - A positive integer indicating the number of initial series/tracks to skip (useful for paging through the results). The default value is 0. The minimum allowed value is 0. The maximum allowed value is MAX\_INT.</div>
          <div className="dd"><code>limit</code> - A positive integer indicating the maximum number of series/tracks to be returned. Or END\_OF\_SET (-9999) to indicate that the max number of results should be returned. The default value is 250.</div>
          <div className="dd"><code>options</code> - Optional parameters. The default value is an empty <a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/util/Map.html" title="class or interface in java.util" className="external-link"><code>Map</code></a>.</div>
          <div className="dt">Returns:</div>
          <div className="dd"><a href="/content/api/java/com/gpudb/protocol/GetRecordsBySeriesResponse" title="class in com.gpudb.protocol"><code>Response</code></a> object containing the results of the operation.</div>
          <div className="dt">Throws:</div>
          <div className="dd"><code><a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/IllegalArgumentException.html" title="class or interface in java.lang" className="external-link">IllegalArgumentException</a></code> - if <code>typeDescriptor</code> is not an instance of one of the following: <a href="/content/api/java/com/gpudb/Type" title="class in com.gpudb"><code>Type</code></a>, <a href="/content/api/java/com/gpudb/TypeObjectMap" title="class in com.gpudb"><code>TypeObjectMap</code></a>, <code>Schema</code>, or a <a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/Class.html" title="class or interface in java.lang" className="external-link"><code>Class</code></a> that implements <code>IndexedRecord</code></div>
          <div className="dd"><code><a href="/content/api/java/com/gpudb/GPUdbException" title="class in com.gpudb">GPUdbException</a></code> - if an error occurs during the operation.</div>
        </div>
      </div>
    </li>

    <li>
      <div className="section detail" id="getRecordsBySeries(com.gpudb.protocol.GetRecordsBySeriesRequest)">
        <h3>getRecordsBySeries</h3>
        <div className="member-signature"><span className="modifiers">public</span> <span className="type-parameters">\<TResponse></span> <span className="return-type"><a href="/content/api/java/com/gpudb/protocol/GetRecordsBySeriesResponse" title="class in com.gpudb.protocol">GetRecordsBySeriesResponse</a>\<TResponse></span> <span className="element-name">getRecordsBySeries</span><wbr /><span className="parameters">(<a href="/content/api/java/com/gpudb/protocol/GetRecordsBySeriesRequest" title="class in com.gpudb.protocol">GetRecordsBySeriesRequest</a> request)</span> throws <span className="exceptions"><a href="/content/api/java/com/gpudb/GPUdbException" title="class in com.gpudb">GPUdbException</a></span></div>

        <div className="block">
          Retrieves the complete series/track records from the given <a href="/content/api/java/com/gpudb/protocol/GetRecordsBySeriesRequest#getWorldTableName()"><code>worldTableName</code></a> based on the partial track information contained in the <a href="/content/api/java/com/gpudb/protocol/GetRecordsBySeriesRequest#getTableName()"><code>tableName</code></a>.
          <p> This operation supports paging through the data via the <a href="/content/api/java/com/gpudb/protocol/GetRecordsBySeriesRequest#getOffset()"><code>offset</code></a> and <a href="/content/api/java/com/gpudb/protocol/GetRecordsBySeriesRequest#getLimit()"><code>limit</code></a> parameters. </p>
          <p> In contrast to <a href="#getRecords(com.gpudb.protocol.GetRecordsRequest)"><code>getRecords</code></a> this returns records grouped by series/track. So if <a href="/content/api/java/com/gpudb/protocol/GetRecordsBySeriesRequest#getOffset()"><code>offset</code></a> is 0 and <a href="/content/api/java/com/gpudb/protocol/GetRecordsBySeriesRequest#getLimit()"><code>limit</code></a> is 5 this operation would return the first 5 series/tracks in <a href="/content/api/java/com/gpudb/protocol/GetRecordsBySeriesRequest#getTableName()"><code>tableName</code></a>. Each series/track will be returned sorted by their TIMESTAMP column.</p>
        </div>

        <div className="dl notes">
          <div className="dt">Type Parameters:</div>
          <div className="dd"><code>TResponse</code> - The type of object being retrieved.</div>
          <div className="dt">Parameters:</div>
          <div className="dd"><code>request</code> - <a href="/content/api/java/com/gpudb/protocol/GetRecordsBySeriesRequest" title="class in com.gpudb.protocol"><code>Request</code></a> object containing the parameters for the operation.</div>
          <div className="dt">Returns:</div>
          <div className="dd"><a href="/content/api/java/com/gpudb/protocol/GetRecordsBySeriesResponse" title="class in com.gpudb.protocol"><code>Response</code></a> object containing the results of the operation.</div>
          <div className="dt">Throws:</div>
          <div className="dd"><code><a href="/content/api/java/com/gpudb/GPUdbException" title="class in com.gpudb">GPUdbException</a></code> - if an error occurs during the operation.</div>
        </div>
      </div>
    </li>

    <li>
      <div className="section detail" id="getRecordsBySeries(java.lang.String,java.lang.String,int,int,java.util.Map)">
        <h3>getRecordsBySeries</h3>
        <div className="member-signature"><span className="modifiers">public</span> <span className="type-parameters">\<TResponse></span> <span className="return-type"><a href="/content/api/java/com/gpudb/protocol/GetRecordsBySeriesResponse" title="class in com.gpudb.protocol">GetRecordsBySeriesResponse</a>\<TResponse></span> <span className="element-name">getRecordsBySeries</span><wbr /><span className="parameters">(<a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/String.html" title="class or interface in java.lang" className="external-link">String</a> tableName, <a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/String.html" title="class or interface in java.lang" className="external-link">String</a> worldTableName, int offset, int limit, <a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/util/Map.html" title="class or interface in java.util" className="external-link">Map</a>\<<a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/String.html" title="class or interface in java.lang" className="external-link">String</a>,<wbr /><a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/String.html" title="class or interface in java.lang" className="external-link">String</a>> options)</span> throws <span className="exceptions"><a href="/content/api/java/com/gpudb/GPUdbException" title="class in com.gpudb">GPUdbException</a></span></div>

        <div className="block">
          Retrieves the complete series/track records from the given <code> worldTableName</code> based on the partial track information contained in the <code>tableName</code>.
          <p> This operation supports paging through the data via the <code>offset</code> and <code>limit</code> parameters. </p>
          <p> In contrast to <a href="#getRecords(java.lang.String,long,long,java.util.Map)"><code>getRecords</code></a> this returns records grouped by series/track. So if <code> offset</code> is 0 and <code>limit</code> is 5 this operation would return the first 5 series/tracks in <code>tableName</code>. Each series/track will be returned sorted by their TIMESTAMP column.</p>
        </div>

        <div className="dl notes">
          <div className="dt">Type Parameters:</div>
          <div className="dd"><code>TResponse</code> - The type of object being retrieved.</div>
          <div className="dt">Parameters:</div>
          <div className="dd"><code>tableName</code> - Name of the table or view for which series/tracks will be fetched, in \[schema\_name.]table\_name format, using standard <a href="/content/concepts/tables/#table-name-resolution" target="_top">name resolution rules</a>.</div>
          <div className="dd"><code>worldTableName</code> - Name of the table containing the complete series/track information to be returned for the tracks present in the <code>tableName</code>, in \[schema\_name.]table\_name format, using standard <a href="/content/concepts/tables/#table-name-resolution" target="_top">name resolution rules</a>. Typically this is used when retrieving series/tracks from a view (which contains partial series/tracks) but the user wants to retrieve the entire original series/tracks. Can be blank.</div>
          <div className="dd"><code>offset</code> - A positive integer indicating the number of initial series/tracks to skip (useful for paging through the results). The default value is 0. The minimum allowed value is 0. The maximum allowed value is MAX\_INT.</div>
          <div className="dd"><code>limit</code> - A positive integer indicating the maximum number of series/tracks to be returned. Or END\_OF\_SET (-9999) to indicate that the max number of results should be returned. The default value is 250.</div>
          <div className="dd"><code>options</code> - Optional parameters. The default value is an empty <a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/util/Map.html" title="class or interface in java.util" className="external-link"><code>Map</code></a>.</div>
          <div className="dt">Returns:</div>
          <div className="dd"><a href="/content/api/java/com/gpudb/protocol/GetRecordsBySeriesResponse" title="class in com.gpudb.protocol"><code>Response</code></a> object containing the results of the operation.</div>
          <div className="dt">Throws:</div>
          <div className="dd"><code><a href="/content/api/java/com/gpudb/GPUdbException" title="class in com.gpudb">GPUdbException</a></code> - if an error occurs during the operation.</div>
        </div>
      </div>
    </li>
  </ul>
</div>