---
schema_version: "1"
id: 4b81e41cfdd659496825f121ec2622da55f459e15004a7710c0df1abae13444e
title: ConnectApi.QuerySqlInput
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/apexref/apex_connectapi_input_query_sql.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_connectapi_input_query_sql.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: fba631e97380126bd7c9bc4de148fa272479b85cb59f8031bf3e74b9be2ae96a
description: Represents the input to create an SQL query.
---
# ConnectApi.QuerySqlInput

Represents the input to create an SQL query.

<table class="featureTable sort_table" summary="">




          <thead class="thead sorted" align="left">
            <tr>
              <th class="featureTableHeader vertical-align-top " id="d710845e46">Property</th>

              <th class="featureTableHeader vertical-align-top " id="d710845e49">Type</th>

              <th class="featureTableHeader vertical-align-top " id="d710845e52">Description</th>

              <th class="featureTableHeader vertical-align-top " id="d710845e55">Required or Optional</th>

              <th class="featureTableHeader vertical-align-top " id="d710845e58">Available Version</th>

            </tr>

          </thead>

          <tbody class="tbody">
            <tr>
              <td class="entry" headers="d710845e46 d710845e58" data-title="Property"><samp class="codeph apex_code">adaptiveTimeout</samp></td>

              <td class="entry" headers="d710845e49" data-title="Type">Integer</td>

              <td class="entry" headers="d710845e52" data-title="Description"><span class="ph" id="adaptiveTimeout"><a name="adaptiveTimeout"><!-- --></a>Amount of time (in seconds) for the query engine to
                  respond to the request. <samp class="codeph apex_code">0</samp> will return the
                  queryId, status, and metadata, but no data associated with the SQL. The maximum
                  value is <samp class="codeph apex_code">15</samp>.</span></td>

              <td class="entry" headers="d710845e55" data-title="Required or Optional">Optional</td>

              <td class="entry" headers="d710845e46 d710845e58" data-title="Property">63.0</td>

            </tr>

            <tr>
              <td class="entry" headers="d710845e46 d710845e58" data-title="Property"><samp class="codeph apex_code">querySettings</samp></td>

              <td class="entry" headers="d710845e49" data-title="Type">
                <a class="xref" href="https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_map.htm#apex_methods_system_map" title="Contains methods for the Map collection type.">Map</a>&lt;String, String&gt;
              </td>

              <td class="entry" headers="d710845e52" data-title="Description">
                <span class="ph" id="querySettings"><a name="querySettings"><!-- --></a>Settings to adjust the query execution behavior:
                </span><a name="querySettingsDetails"><!-- --></a>
                <ul class="ul bulletList" id="querySettingsDetails">
                  <li class="li">
                    <samp class="codeph apex_code">date_style</samp>—Order of Year, Month, and
                    Day for parsing date strings, for example <samp class="codeph apex_code">MDY</samp> and <samp class="codeph apex_code">DMY</samp>.
                  </li>

                  <li class="li">
                    <samp class="codeph apex_code">lc_time</samp>—Locale for date literals
                    using ISO language and country code, for example <samp class="codeph apex_code">en_US</samp> and <samp class="codeph apex_code">de_AT</samp>.
                  </li>

                  <li class="li">
                    <samp class="codeph apex_code">query_timeout</samp>—Execution limit in
                    milliseconds before the query is terminated, for example <samp class="codeph apex_code">1800000ms</samp>.
                  </li>

                </ul>
              </td>

              <td class="entry" headers="d710845e55" data-title="Required or Optional">Optional</td>

              <td class="entry" headers="d710845e46 d710845e58" data-title="Property">62.0</td>

            </tr>

            <tr>
              <td class="entry" headers="d710845e46 d710845e58" data-title="Property"><samp class="codeph apex_code">rowLimit</samp></td>

              <td class="entry" headers="d710845e49" data-title="Type">Long</td>

              <td class="entry" headers="d710845e52" data-title="Description"><span class="ph" id="rowLimit"><a name="rowLimit"><!-- --></a>Maximum number of rows to include in the response. Fewer rows
                  may be returned.</span></td>

              <td class="entry" headers="d710845e55" data-title="Required or Optional">Optional</td>

              <td class="entry" headers="d710845e46 d710845e58" data-title="Property">62.0</td>

            </tr>

            <tr>
              <td class="entry" headers="d710845e46 d710845e58" data-title="Property"><samp class="codeph apex_code">sql</samp></td>

              <td class="entry" headers="d710845e49" data-title="Type">String</td>

              <td class="entry" headers="d710845e52" data-title="Description"><span class="ph" id="sql"><a name="sql"><!-- --></a>SQL expression.</span></td>

              <td class="entry" headers="d710845e55" data-title="Required or Optional">Required</td>

              <td class="entry" headers="d710845e46 d710845e58" data-title="Property">62.0</td>

            </tr>

            <tr>
              <td class="entry" headers="d710845e46 d710845e58" data-title="Property"><samp class="codeph apex_code">sqlParameters</samp></td>

              <td class="entry" headers="d710845e49" data-title="Type">
                <a class="xref" href="https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_list.htm#apex_methods_system_list" title="Contains methods for the List collection type.">List</a>&lt;<a class="xref" href="https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_connectapi_input_query_sql_parameter_item_representatio.htm" title="Represents the parameter fields for an SQL query input."><samp class="codeph apex_code">ConnectApi.QuerySqlParameterItem</samp></a>&gt;
              </td>

              <td class="entry" headers="d710845e52" data-title="Description"><span class="ph" id="sqlParameters"><a name="sqlParameters"><!-- --></a>Value and type information about the SQL
                  parameters.</span></td>

              <td class="entry" headers="d710845e55" data-title="Required or Optional">Optional</td>

              <td class="entry" headers="d710845e46 d710845e58" data-title="Property">62.0</td>

            </tr>

          </tbody>

        </table>

#### See Also

- [querySql(input)](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_ConnectAPI_CdpQuery_static_methods.htm#apex_ConnectAPI_CdpQuery_querySql_1 "Submit an SQL query request for execution and retrieve the first chunk of data.")
- [querySql(input, dataspace)](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_ConnectAPI_CdpQuery_static_methods.htm#apex_ConnectAPI_CdpQuery_querySql_2 "Submit an SQL query request for execution and specify the data space.")
- [querySql(input, workloadName, dataspace)](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_ConnectAPI_CdpQuery_static_methods.htm#apex_ConnectAPI_CdpQuery_querySql_3 "Submit an SQL query request for execution and specify the workload name and data space.")