> ## 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.

# alterDatasource

<div className="kinetica-javadoc">
  <ul className="member-list">
    <li>
      <div className="section detail" id="alterDatasource(com.gpudb.protocol.AlterDatasourceRequest)">
        <h3>alterDatasource</h3>
        <div className="member-signature"><span className="modifiers">public</span> <span className="return-type"><a href="/content/api/java/com/gpudb/protocol/AlterDatasourceResponse" title="class in com.gpudb.protocol">AlterDatasourceResponse</a></span> <span className="element-name">alterDatasource</span><wbr /><span className="parameters">(<a href="/content/api/java/com/gpudb/protocol/AlterDatasourceRequest" title="class in com.gpudb.protocol">AlterDatasourceRequest</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">Alters the properties of an existing <a href="/content/concepts/data_sources/" target="_top">data source</a>.</div>

        <div className="dl notes">
          <div className="dt">Parameters:</div>
          <div className="dd"><code>request</code> - <a href="/content/api/java/com/gpudb/protocol/AlterDatasourceRequest" 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/AlterDatasourceResponse" 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="alterDatasource(java.lang.String,java.util.Map,java.util.Map)">
        <h3>alterDatasource</h3>
        <div className="member-signature"><span className="modifiers">public</span> <span className="return-type"><a href="/content/api/java/com/gpudb/protocol/AlterDatasourceResponse" title="class in com.gpudb.protocol">AlterDatasourceResponse</a></span> <span className="element-name">alterDatasource</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> name, <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>> datasourceUpdatesMap, <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">Alters the properties of an existing <a href="/content/concepts/data_sources/" target="_top">data source</a>.</div>

        <div className="dl notes">
          <div className="dt">Parameters:</div>
          <div className="dd"><code>name</code> - Name of the data source to be altered. Must be an existing data source.</div>

          <div className="dd">
            <code>datasourceUpdatesMap</code> - Map containing the properties of the data source to be updated. Error if empty.

            <ul>
              <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasourceRequest.DatasourceUpdatesMap#LOCATION"><code>LOCATION</code></a>: Location of the remote storage in 'storage\_provider\_type://\[storage\_path\[:storage\_port]]' format. Supported storage provider types are 'azure', 'gcs', 'hdfs', 'jdbc', 'kafka', 'confluent', and 's3'. </li>
              <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasourceRequest.DatasourceUpdatesMap#USER_NAME"><code>USER\_NAME</code></a>: Name of the remote system user; may be an empty string. </li>
              <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasourceRequest.DatasourceUpdatesMap#PASSWORD"><code>PASSWORD</code></a>: Password for the remote system user; may be an empty string. </li>

              <li>
                <a href="/content/api/java/com/gpudb/protocol/AlterDatasourceRequest.DatasourceUpdatesMap#SKIP_VALIDATION"><code>SKIP\_VALIDATION</code></a>: Bypass validation of connection to remote source. Supported values:

                <ul>
                  <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasourceRequest.DatasourceUpdatesMap#TRUE"><code>TRUE</code></a> </li>
                  <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasourceRequest.DatasourceUpdatesMap#FALSE"><code>FALSE</code></a> </li>
                </ul>

                The default value is <a href="/content/api/java/com/gpudb/protocol/AlterDatasourceRequest.DatasourceUpdatesMap#FALSE"><code>FALSE</code></a>.
              </li>

              <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasourceRequest.DatasourceUpdatesMap#CONNECTION_TIMEOUT"><code>CONNECTION\_TIMEOUT</code></a>: Timeout in seconds for connecting to this storage provider. </li>
              <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasourceRequest.DatasourceUpdatesMap#WAIT_TIMEOUT"><code>WAIT\_TIMEOUT</code></a>: Timeout in seconds for reading from this storage provider. </li>
              <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasourceRequest.DatasourceUpdatesMap#CREDENTIAL"><code>CREDENTIAL</code></a>: Name of the <a href="/content/concepts/credentials" target="_top">credential</a> object to be used in data source. </li>
              <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasourceRequest.DatasourceUpdatesMap#S3_BUCKET_NAME"><code>S3\_BUCKET\_NAME</code></a>: Name of the Amazon S3 bucket to use as the data source. </li>
              <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasourceRequest.DatasourceUpdatesMap#S3_REGION"><code>S3\_REGION</code></a>: Name of the Amazon S3 region where the given bucket is located. </li>

              <li>
                <a href="/content/api/java/com/gpudb/protocol/AlterDatasourceRequest.DatasourceUpdatesMap#S3_VERIFY_SSL"><code>S3\_VERIFY\_SSL</code></a>: Whether to verify SSL connections. Supported values:

                <ul>
                  <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasourceRequest.DatasourceUpdatesMap#TRUE"><code>TRUE</code></a>: Connect with SSL verification. </li>
                  <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasourceRequest.DatasourceUpdatesMap#FALSE"><code>FALSE</code></a>: Connect without verifying the SSL connection; for testing purposes, bypassing TLS errors, self-signed certificates, etc. </li>
                </ul>

                The default value is <a href="/content/api/java/com/gpudb/protocol/AlterDatasourceRequest.DatasourceUpdatesMap#TRUE"><code>TRUE</code></a>.
              </li>

              <li>
                <a href="/content/api/java/com/gpudb/protocol/AlterDatasourceRequest.DatasourceUpdatesMap#S3_USE_VIRTUAL_ADDRESSING"><code>S3\_USE\_VIRTUAL\_ADDRESSING</code></a>: Whether to use virtual addressing when referencing the Amazon S3 source. Supported values:

                <ul>
                  <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasourceRequest.DatasourceUpdatesMap#TRUE"><code>TRUE</code></a>: The requests URI should be specified in virtual-hosted-style format where the bucket name is part of the domain name in the URL. </li>
                  <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasourceRequest.DatasourceUpdatesMap#FALSE"><code>FALSE</code></a>: Use path-style URI for requests. </li>
                </ul>

                The default value is <a href="/content/api/java/com/gpudb/protocol/AlterDatasourceRequest.DatasourceUpdatesMap#TRUE"><code>TRUE</code></a>.
              </li>

              <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasourceRequest.DatasourceUpdatesMap#S3_AWS_ROLE_ARN"><code>S3\_AWS\_ROLE\_ARN</code></a>: Amazon IAM Role ARN which has required S3 permissions that can be assumed for the given S3 IAM user. </li>
              <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasourceRequest.DatasourceUpdatesMap#S3_ENCRYPTION_CUSTOMER_ALGORITHM"><code>S3\_ENCRYPTION\_CUSTOMER\_ALGORITHM</code></a>: Customer encryption algorithm used encrypting data. </li>
              <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasourceRequest.DatasourceUpdatesMap#S3_ENCRYPTION_CUSTOMER_KEY"><code>S3\_ENCRYPTION\_CUSTOMER\_KEY</code></a>: Customer encryption key to encrypt or decrypt data. </li>
              <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasourceRequest.DatasourceUpdatesMap#HDFS_KERBEROS_KEYTAB"><code>HDFS\_KERBEROS\_KEYTAB</code></a>: Kerberos keytab file location for the given HDFS user. This may be a KIFS file. </li>
              <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasourceRequest.DatasourceUpdatesMap#HDFS_DELEGATION_TOKEN"><code>HDFS\_DELEGATION\_TOKEN</code></a>: Delegation token for the given HDFS user. </li>

              <li>
                <a href="/content/api/java/com/gpudb/protocol/AlterDatasourceRequest.DatasourceUpdatesMap#HDFS_USE_KERBEROS"><code>HDFS\_USE\_KERBEROS</code></a>: Use kerberos authentication for the given HDFS cluster. Supported values:

                <ul>
                  <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasourceRequest.DatasourceUpdatesMap#TRUE"><code>TRUE</code></a> </li>
                  <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasourceRequest.DatasourceUpdatesMap#FALSE"><code>FALSE</code></a> </li>
                </ul>

                The default value is <a href="/content/api/java/com/gpudb/protocol/AlterDatasourceRequest.DatasourceUpdatesMap#FALSE"><code>FALSE</code></a>.
              </li>

              <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasourceRequest.DatasourceUpdatesMap#AZURE_STORAGE_ACCOUNT_NAME"><code>AZURE\_STORAGE\_ACCOUNT\_NAME</code></a>: Name of the Azure storage account to use as the data source, this is valid only if tenant\_id is specified. </li>
              <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasourceRequest.DatasourceUpdatesMap#AZURE_CONTAINER_NAME"><code>AZURE\_CONTAINER\_NAME</code></a>: Name of the Azure storage container to use as the data source. </li>
              <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasourceRequest.DatasourceUpdatesMap#AZURE_TENANT_ID"><code>AZURE\_TENANT\_ID</code></a>: Active Directory tenant ID (or directory ID). </li>
              <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasourceRequest.DatasourceUpdatesMap#AZURE_SAS_TOKEN"><code>AZURE\_SAS\_TOKEN</code></a>: Shared access signature token for Azure storage account to use as the data source. </li>
              <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasourceRequest.DatasourceUpdatesMap#AZURE_OAUTH_TOKEN"><code>AZURE\_OAUTH\_TOKEN</code></a>: OAuth token to access given storage container. </li>

              <li>
                <a href="/content/api/java/com/gpudb/protocol/AlterDatasourceRequest.DatasourceUpdatesMap#AZURE_USE_VIRTUAL_ADDRESSING"><code>AZURE\_USE\_VIRTUAL\_ADDRESSING</code></a>: Whether to use virtual addressing when referencing the Azure source. Supported values:

                <ul>
                  <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasourceRequest.DatasourceUpdatesMap#TRUE"><code>TRUE</code></a>: The requests URI should be specified in virtual-hosted-style format where the bucket name is part of the domain name in the URL. </li>
                  <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasourceRequest.DatasourceUpdatesMap#FALSE"><code>FALSE</code></a>: Use path-style URI for requests. </li>
                </ul>

                The default value is <a href="/content/api/java/com/gpudb/protocol/AlterDatasourceRequest.DatasourceUpdatesMap#TRUE"><code>TRUE</code></a>.
              </li>

              <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasourceRequest.DatasourceUpdatesMap#GCS_BUCKET_NAME"><code>GCS\_BUCKET\_NAME</code></a>: Name of the Google Cloud Storage bucket to use as the data source. </li>
              <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasourceRequest.DatasourceUpdatesMap#GCS_PROJECT_ID"><code>GCS\_PROJECT\_ID</code></a>: Name of the Google Cloud project to use as the data source. </li>
              <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasourceRequest.DatasourceUpdatesMap#GCS_SERVICE_ACCOUNT_KEYS"><code>GCS\_SERVICE\_ACCOUNT\_KEYS</code></a>: Google Cloud service account keys to use for authenticating the data source. </li>
              <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasourceRequest.DatasourceUpdatesMap#JDBC_DRIVER_JAR_PATH"><code>JDBC\_DRIVER\_JAR\_PATH</code></a>: JDBC driver jar file location. This may be a KIFS file. </li>
              <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasourceRequest.DatasourceUpdatesMap#JDBC_DRIVER_CLASS_NAME"><code>JDBC\_DRIVER\_CLASS\_NAME</code></a>: Name of the JDBC driver class. </li>
              <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasourceRequest.DatasourceUpdatesMap#KAFKA_URL"><code>KAFKA\_URL</code></a>: The publicly-accessible full path URL to the Kafka broker, e.g., '[http://172.123.45.67:9300](http://172.123.45.67:9300)'. </li>
              <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasourceRequest.DatasourceUpdatesMap#KAFKA_TOPIC_NAME"><code>KAFKA\_TOPIC\_NAME</code></a>: Name of the Kafka topic to use as the data source. </li>

              <li>
                <a href="/content/api/java/com/gpudb/protocol/AlterDatasourceRequest.DatasourceUpdatesMap#ANONYMOUS"><code>ANONYMOUS</code></a>: Create an anonymous connection to the storage provider--DEPRECATED: this is now the default. Specify use\_managed\_credentials for non-anonymous connection. Supported values:

                <ul>
                  <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasourceRequest.DatasourceUpdatesMap#TRUE"><code>TRUE</code></a> </li>
                  <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasourceRequest.DatasourceUpdatesMap#FALSE"><code>FALSE</code></a> </li>
                </ul>

                The default value is <a href="/content/api/java/com/gpudb/protocol/AlterDatasourceRequest.DatasourceUpdatesMap#TRUE"><code>TRUE</code></a>.
              </li>

              <li>
                <a href="/content/api/java/com/gpudb/protocol/AlterDatasourceRequest.DatasourceUpdatesMap#USE_MANAGED_CREDENTIALS"><code>USE\_MANAGED\_CREDENTIALS</code></a>: When no credentials are supplied, we use anonymous access by default. If this is set, we will use cloud provider user settings. Supported values:

                <ul>
                  <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasourceRequest.DatasourceUpdatesMap#TRUE"><code>TRUE</code></a> </li>
                  <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasourceRequest.DatasourceUpdatesMap#FALSE"><code>FALSE</code></a> </li>
                </ul>

                The default value is <a href="/content/api/java/com/gpudb/protocol/AlterDatasourceRequest.DatasourceUpdatesMap#FALSE"><code>FALSE</code></a>.
              </li>

              <li>
                <a href="/content/api/java/com/gpudb/protocol/AlterDatasourceRequest.DatasourceUpdatesMap#USE_HTTPS"><code>USE\_HTTPS</code></a>: Use HTTPS to connect to datasource if true, otherwise use HTTP. Supported values:

                <ul>
                  <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasourceRequest.DatasourceUpdatesMap#TRUE"><code>TRUE</code></a> </li>
                  <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasourceRequest.DatasourceUpdatesMap#FALSE"><code>FALSE</code></a> </li>
                </ul>

                The default value is <a href="/content/api/java/com/gpudb/protocol/AlterDatasourceRequest.DatasourceUpdatesMap#TRUE"><code>TRUE</code></a>.
              </li>

              <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasourceRequest.DatasourceUpdatesMap#SCHEMA_NAME"><code>SCHEMA\_NAME</code></a>: Updates the schema name. If <a href="/content/api/java/com/gpudb/protocol/AlterDatasourceRequest.DatasourceUpdatesMap#SCHEMA_NAME"><code>SCHEMA\_NAME</code></a> doesn't exist, an error will be thrown. If <a href="/content/api/java/com/gpudb/protocol/AlterDatasourceRequest.DatasourceUpdatesMap#SCHEMA_NAME"><code>SCHEMA\_NAME</code></a> is empty, then the user's default schema will be used. </li>
              <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasourceRequest.DatasourceUpdatesMap#SCHEMA_REGISTRY_CONNECTION_RETRIES"><code>SCHEMA\_REGISTRY\_CONNECTION\_RETRIES</code></a>: Confluent Schema registry connection timeout (in secs). </li>
              <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasourceRequest.DatasourceUpdatesMap#SCHEMA_REGISTRY_CONNECTION_TIMEOUT"><code>SCHEMA\_REGISTRY\_CONNECTION\_TIMEOUT</code></a>: Confluent Schema registry connection timeout (in secs). </li>
              <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasourceRequest.DatasourceUpdatesMap#SCHEMA_REGISTRY_CREDENTIAL"><code>SCHEMA\_REGISTRY\_CREDENTIAL</code></a>: Confluent Schema Registry <a href="/content/concepts/credentials" target="_top">credential</a> object name. </li>
              <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasourceRequest.DatasourceUpdatesMap#SCHEMA_REGISTRY_LOCATION"><code>SCHEMA\_REGISTRY\_LOCATION</code></a>: Location of Confluent Schema Registry in '\[storage\_path\[:storage\_port]]' format. </li>
              <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasourceRequest.DatasourceUpdatesMap#SCHEMA_REGISTRY_PORT"><code>SCHEMA\_REGISTRY\_PORT</code></a>: Confluent Schema Registry port (optional). </li>
            </ul>
          </div>

          <div className="dd"><code>options</code> - Optional parameters.</div>
          <div className="dt">Returns:</div>
          <div className="dd"><a href="/content/api/java/com/gpudb/protocol/AlterDatasourceResponse" 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>