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

# alterDatasink

<div className="kinetica-javadoc">
  <ul className="member-list">
    <li>
      <div className="section detail" id="alterDatasink(com.gpudb.protocol.AlterDatasinkRequest)">
        <h3>alterDatasink</h3>
        <div className="member-signature"><span className="modifiers">public</span> <span className="return-type"><a href="/content/api/java/com/gpudb/protocol/AlterDatasinkResponse" title="class in com.gpudb.protocol">AlterDatasinkResponse</a></span> <span className="element-name">alterDatasink</span><wbr /><span className="parameters">(<a href="/content/api/java/com/gpudb/protocol/AlterDatasinkRequest" title="class in com.gpudb.protocol">AlterDatasinkRequest</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_sinks/" target="_top">data sink</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/AlterDatasinkRequest" 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/AlterDatasinkResponse" 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="alterDatasink(java.lang.String,java.util.Map,java.util.Map)">
        <h3>alterDatasink</h3>
        <div className="member-signature"><span className="modifiers">public</span> <span className="return-type"><a href="/content/api/java/com/gpudb/protocol/AlterDatasinkResponse" title="class in com.gpudb.protocol">AlterDatasinkResponse</a></span> <span className="element-name">alterDatasink</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>> datasinkUpdatesMap, <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_sinks/" target="_top">data sink</a>.</div>

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

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

            <ul>
              <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasinkRequest.DatasinkUpdatesMap#DESTINATION"><code>DESTINATION</code></a>: Destination for the output data in format 'destination\_type://path\[:port]'. Supported destination types are 'azure', 'gcs', 'hdfs', 'http', 'https', 'jdbc', 'kafka', and 's3'. </li>
              <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasinkRequest.DatasinkUpdatesMap#CONNECTION_TIMEOUT"><code>CONNECTION\_TIMEOUT</code></a>: Timeout in seconds for connecting to this sink. </li>
              <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasinkRequest.DatasinkUpdatesMap#WAIT_TIMEOUT"><code>WAIT\_TIMEOUT</code></a>: Timeout in seconds for waiting for a response from this sink. </li>
              <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasinkRequest.DatasinkUpdatesMap#CREDENTIAL"><code>CREDENTIAL</code></a>: Name of the <a href="/content/concepts/credentials/" target="_top">credential</a> object to be used in this data sink. </li>
              <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasinkRequest.DatasinkUpdatesMap#S3_BUCKET_NAME"><code>S3\_BUCKET\_NAME</code></a>: Name of the Amazon S3 bucket to use as the data sink. </li>
              <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasinkRequest.DatasinkUpdatesMap#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/AlterDatasinkRequest.DatasinkUpdatesMap#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/AlterDatasinkRequest.DatasinkUpdatesMap#TRUE"><code>TRUE</code></a>: Connect with SSL verification. </li>
                  <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasinkRequest.DatasinkUpdatesMap#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/AlterDatasinkRequest.DatasinkUpdatesMap#TRUE"><code>TRUE</code></a>.
              </li>

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

                <ul>
                  <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasinkRequest.DatasinkUpdatesMap#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/AlterDatasinkRequest.DatasinkUpdatesMap#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/AlterDatasinkRequest.DatasinkUpdatesMap#TRUE"><code>TRUE</code></a>.
              </li>

              <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasinkRequest.DatasinkUpdatesMap#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/AlterDatasinkRequest.DatasinkUpdatesMap#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/AlterDatasinkRequest.DatasinkUpdatesMap#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/AlterDatasinkRequest.DatasinkUpdatesMap#S3_ENCRYPTION_TYPE"><code>S3\_ENCRYPTION\_TYPE</code></a>: Server side encryption type. </li>
              <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasinkRequest.DatasinkUpdatesMap#S3_KMS_KEY_ID"><code>S3\_KMS\_KEY\_ID</code></a>: KMS key. </li>
              <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasinkRequest.DatasinkUpdatesMap#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/AlterDatasinkRequest.DatasinkUpdatesMap#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/AlterDatasinkRequest.DatasinkUpdatesMap#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/AlterDatasinkRequest.DatasinkUpdatesMap#TRUE"><code>TRUE</code></a> </li>
                  <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasinkRequest.DatasinkUpdatesMap#FALSE"><code>FALSE</code></a> </li>
                </ul>

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

              <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasinkRequest.DatasinkUpdatesMap#AZURE_STORAGE_ACCOUNT_NAME"><code>AZURE\_STORAGE\_ACCOUNT\_NAME</code></a>: Name of the Azure storage account to use as the data sink, this is valid only if tenant\_id is specified. </li>
              <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasinkRequest.DatasinkUpdatesMap#AZURE_CONTAINER_NAME"><code>AZURE\_CONTAINER\_NAME</code></a>: Name of the Azure storage container to use as the data sink. </li>
              <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasinkRequest.DatasinkUpdatesMap#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/AlterDatasinkRequest.DatasinkUpdatesMap#AZURE_SAS_TOKEN"><code>AZURE\_SAS\_TOKEN</code></a>: Shared access signature token for Azure storage account to use as the data sink. </li>
              <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasinkRequest.DatasinkUpdatesMap#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/AlterDatasinkRequest.DatasinkUpdatesMap#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/AlterDatasinkRequest.DatasinkUpdatesMap#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/AlterDatasinkRequest.DatasinkUpdatesMap#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/AlterDatasinkRequest.DatasinkUpdatesMap#TRUE"><code>TRUE</code></a>.
              </li>

              <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasinkRequest.DatasinkUpdatesMap#GCS_BUCKET_NAME"><code>GCS\_BUCKET\_NAME</code></a>: Name of the Google Cloud Storage bucket to use as the data sink. </li>
              <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasinkRequest.DatasinkUpdatesMap#GCS_PROJECT_ID"><code>GCS\_PROJECT\_ID</code></a>: Name of the Google Cloud project to use as the data sink. </li>
              <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasinkRequest.DatasinkUpdatesMap#GCS_SERVICE_ACCOUNT_KEYS"><code>GCS\_SERVICE\_ACCOUNT\_KEYS</code></a>: Google Cloud service account keys to use for authenticating the data sink. </li>
              <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasinkRequest.DatasinkUpdatesMap#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/AlterDatasinkRequest.DatasinkUpdatesMap#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/AlterDatasinkRequest.DatasinkUpdatesMap#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/AlterDatasinkRequest.DatasinkUpdatesMap#KAFKA_TOPIC_NAME"><code>KAFKA\_TOPIC\_NAME</code></a>: Name of the Kafka topic to use for this data sink, if it references a Kafka broker. </li>

              <li>
                <a href="/content/api/java/com/gpudb/protocol/AlterDatasinkRequest.DatasinkUpdatesMap#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/AlterDatasinkRequest.DatasinkUpdatesMap#TRUE"><code>TRUE</code></a> </li>
                  <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasinkRequest.DatasinkUpdatesMap#FALSE"><code>FALSE</code></a> </li>
                </ul>

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

              <li>
                <a href="/content/api/java/com/gpudb/protocol/AlterDatasinkRequest.DatasinkUpdatesMap#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/AlterDatasinkRequest.DatasinkUpdatesMap#TRUE"><code>TRUE</code></a> </li>
                  <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasinkRequest.DatasinkUpdatesMap#FALSE"><code>FALSE</code></a> </li>
                </ul>

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

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

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

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

              <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasinkRequest.DatasinkUpdatesMap#MAX_BATCH_SIZE"><code>MAX\_BATCH\_SIZE</code></a>: Maximum number of records per notification message. The default value is '1'. </li>
              <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasinkRequest.DatasinkUpdatesMap#MAX_MESSAGE_SIZE"><code>MAX\_MESSAGE\_SIZE</code></a>: Maximum size in bytes of each notification message. The default value is '1000000'. </li>

              <li>
                <a href="/content/api/java/com/gpudb/protocol/AlterDatasinkRequest.DatasinkUpdatesMap#JSON_FORMAT"><code>JSON\_FORMAT</code></a>: The desired format of JSON encoded notifications message. Supported values:

                <ul>
                  <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasinkRequest.DatasinkUpdatesMap#FLAT"><code>FLAT</code></a>: A single record is returned per message. </li>
                  <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasinkRequest.DatasinkUpdatesMap#NESTED"><code>NESTED</code></a>: Records are returned as an array per message. </li>
                </ul>

                The default value is <a href="/content/api/java/com/gpudb/protocol/AlterDatasinkRequest.DatasinkUpdatesMap#FLAT"><code>FLAT</code></a>.
              </li>

              <li>
                <a href="/content/api/java/com/gpudb/protocol/AlterDatasinkRequest.DatasinkUpdatesMap#SKIP_VALIDATION"><code>SKIP\_VALIDATION</code></a>: Bypass validation of connection to this data sink. Supported values:

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

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

              <li><a href="/content/api/java/com/gpudb/protocol/AlterDatasinkRequest.DatasinkUpdatesMap#SCHEMA_NAME"><code>SCHEMA\_NAME</code></a>: Updates the schema name. If <a href="/content/api/java/com/gpudb/protocol/AlterDatasinkRequest.DatasinkUpdatesMap#SCHEMA_NAME"><code>SCHEMA\_NAME</code></a> doesn't exist, an error will be thrown. If <a href="/content/api/java/com/gpudb/protocol/AlterDatasinkRequest.DatasinkUpdatesMap#SCHEMA_NAME"><code>SCHEMA\_NAME</code></a> is empty, then the user's default schema will be used. </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/AlterDatasinkResponse" 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>