Class MongoDbSettings

java.lang.Object
software.amazon.awssdk.services.databasemigration.model.MongoDbSettings
All Implemented Interfaces:
Serializable, SdkPojo, ToCopyableBuilder<MongoDbSettings.Builder,MongoDbSettings>
@Generated("software.amazon.awssdk:codegen") public final class MongoDbSettings extends Object implements SdkPojo, Serializable, ToCopyableBuilder<MongoDbSettings.Builder,MongoDbSettings>

Provides information that defines a MongoDB endpoint.

See Also:

  • Method Details

    • username

      public final String username()

      The user name you use to access the MongoDB source endpoint.

      Returns:
      The user name you use to access the MongoDB source endpoint.

    • password

      public final String password()

      The password for the user account you use to access the MongoDB source endpoint.

      Returns:
      The password for the user account you use to access the MongoDB source endpoint.

    • serverName

      public final String serverName()

      The name of the server on the MongoDB source endpoint. For MongoDB Atlas, provide the server name for any of the servers in the replication set.

      Returns:
      The name of the server on the MongoDB source endpoint. For MongoDB Atlas, provide the server name for any of the servers in the replication set.

    • port

      public final Integer port()

      The port value for the MongoDB source endpoint.

      Returns:
      The port value for the MongoDB source endpoint.

    • databaseName

      public final String databaseName()

      The database name on the MongoDB source endpoint.

      Returns:
      The database name on the MongoDB source endpoint.

    • authType

      public final AuthTypeValue authType()

      The authentication type you use to access the MongoDB source endpoint.

      When when set to "no", user name and password parameters are not used and can be empty.

      If the service returns an enum value that is not available in the current SDK version, authType will return AuthTypeValue.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from authTypeAsString().

      Returns:
      The authentication type you use to access the MongoDB source endpoint.

      When when set to "no", user name and password parameters are not used and can be empty.

      See Also:

    • authTypeAsString

      public final String authTypeAsString()

      The authentication type you use to access the MongoDB source endpoint.

      When when set to "no", user name and password parameters are not used and can be empty.

      If the service returns an enum value that is not available in the current SDK version, authType will return AuthTypeValue.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from authTypeAsString().

      Returns:
      The authentication type you use to access the MongoDB source endpoint.

      When when set to "no", user name and password parameters are not used and can be empty.

      See Also:

    • authMechanism

      public final AuthMechanismValue authMechanism()

      The authentication mechanism you use to access the MongoDB source endpoint.

      For the default value, in MongoDB version 2.x, "default" is "mongodb_cr". For MongoDB version 3.x or later, "default" is "scram_sha_1". This setting isn't used when AuthType is set to "no".

      If the service returns an enum value that is not available in the current SDK version, authMechanism will return AuthMechanismValue.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from authMechanismAsString().

      Returns:
      The authentication mechanism you use to access the MongoDB source endpoint.

      For the default value, in MongoDB version 2.x, "default" is "mongodb_cr". For MongoDB version 3.x or later, "default" is "scram_sha_1". This setting isn't used when AuthType is set to "no".

      See Also:

    • authMechanismAsString

      public final String authMechanismAsString()

      The authentication mechanism you use to access the MongoDB source endpoint.

      For the default value, in MongoDB version 2.x, "default" is "mongodb_cr". For MongoDB version 3.x or later, "default" is "scram_sha_1". This setting isn't used when AuthType is set to "no".

      If the service returns an enum value that is not available in the current SDK version, authMechanism will return AuthMechanismValue.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from authMechanismAsString().

      Returns:
      The authentication mechanism you use to access the MongoDB source endpoint.

      For the default value, in MongoDB version 2.x, "default" is "mongodb_cr". For MongoDB version 3.x or later, "default" is "scram_sha_1". This setting isn't used when AuthType is set to "no".

      See Also:

    • nestingLevel

      public final NestingLevelValue nestingLevel()

      Specifies either document or table mode.

      Default value is "none". Specify "none" to use document mode. Specify "one" to use table mode.

      If the service returns an enum value that is not available in the current SDK version, nestingLevel will return NestingLevelValue.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from nestingLevelAsString().

      Returns:
      Specifies either document or table mode.

      Default value is "none". Specify "none" to use document mode. Specify "one" to use table mode.

      See Also:

    • nestingLevelAsString

      public final String nestingLevelAsString()

      Specifies either document or table mode.

      Default value is "none". Specify "none" to use document mode. Specify "one" to use table mode.

      If the service returns an enum value that is not available in the current SDK version, nestingLevel will return NestingLevelValue.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from nestingLevelAsString().

      Returns:
      Specifies either document or table mode.

      Default value is "none". Specify "none" to use document mode. Specify "one" to use table mode.

      See Also:

    • extractDocId

      public final String extractDocId()

      Specifies the document ID. Use this setting when NestingLevel is set to "none".

      Default value is "false".

      Returns:
      Specifies the document ID. Use this setting when NestingLevel is set to "none".

      Default value is "false".

    • docsToInvestigate

      public final String docsToInvestigate()

      Indicates the number of documents to preview to determine the document organization. Use this setting when NestingLevel is set to "one".

      Must be a positive value greater than 0. Default value is 1000.

      Returns:
      Indicates the number of documents to preview to determine the document organization. Use this setting when NestingLevel is set to "one".

      Must be a positive value greater than 0. Default value is 1000.

    • authSource

      public final String authSource()

      The MongoDB database name. This setting isn't used when AuthType is set to "no".

      The default is "admin".

      Returns:
      The MongoDB database name. This setting isn't used when AuthType is set to "no" .

      The default is "admin".

    • kmsKeyId

      public final String kmsKeyId()

      The KMS key identifier that is used to encrypt the content on the replication instance. If you don't specify a value for the KmsKeyId parameter, then DMS uses your default encryption key. KMS creates the default encryption key for your Amazon Web Services account. Your Amazon Web Services account has a different default encryption key for each Amazon Web Services Region.

      Returns:
      The KMS key identifier that is used to encrypt the content on the replication instance. If you don't specify a value for the KmsKeyId parameter, then DMS uses your default encryption key. KMS creates the default encryption key for your Amazon Web Services account. Your Amazon Web Services account has a different default encryption key for each Amazon Web Services Region.

    • secretsManagerAccessRoleArn

      public final String secretsManagerAccessRoleArn()

      The full Amazon Resource Name (ARN) of the IAM role that specifies DMS as the trusted entity and grants the required permissions to access the value in SecretsManagerSecret. The role must allow the iam:PassRole action. SecretsManagerSecret has the value of the Amazon Web Services Secrets Manager secret that allows access to the MongoDB endpoint.

      You can specify one of two sets of values for these permissions. You can specify the values for this setting and SecretsManagerSecretId. Or you can specify clear-text values for UserName, Password, ServerName, and Port. You can't specify both. For more information on creating this SecretsManagerSecret and the SecretsManagerAccessRoleArn and SecretsManagerSecretId required to access it, see Using secrets to access Database Migration Service resources in the Database Migration Service User Guide.

      Returns:
      The full Amazon Resource Name (ARN) of the IAM role that specifies DMS as the trusted entity and grants the required permissions to access the value in SecretsManagerSecret. The role must allow the iam:PassRole action. SecretsManagerSecret has the value of the Amazon Web Services Secrets Manager secret that allows access to the MongoDB endpoint.

      You can specify one of two sets of values for these permissions. You can specify the values for this setting and SecretsManagerSecretId. Or you can specify clear-text values for UserName, Password, ServerName, and Port. You can't specify both. For more information on creating this SecretsManagerSecret and the SecretsManagerAccessRoleArn and SecretsManagerSecretId required to access it, see Using secrets to access Database Migration Service resources in the Database Migration Service User Guide.

    • secretsManagerSecretId

      public final String secretsManagerSecretId()

      The full ARN, partial ARN, or friendly name of the SecretsManagerSecret that contains the MongoDB endpoint connection details.

      Returns:
      The full ARN, partial ARN, or friendly name of the SecretsManagerSecret that contains the MongoDB endpoint connection details.

    • useUpdateLookUp

      public final Boolean useUpdateLookUp()

      If true, DMS retrieves the entire document from the MongoDB source during migration. This may cause a migration failure if the server response exceeds bandwidth limits. To fetch only updates and deletes during migration, set this parameter to false.

      Returns:
      If true, DMS retrieves the entire document from the MongoDB source during migration. This may cause a migration failure if the server response exceeds bandwidth limits. To fetch only updates and deletes during migration, set this parameter to false.

    • replicateShardCollections

      public final Boolean replicateShardCollections()

      If true, DMS replicates data to shard collections. DMS only uses this setting if the target endpoint is a DocumentDB elastic cluster.

      When this setting is true, note the following:

      • You must set TargetTablePrepMode to nothing.

      • DMS automatically sets useUpdateLookup to false.

      Returns:
      If true, DMS replicates data to shard collections. DMS only uses this setting if the target endpoint is a DocumentDB elastic cluster.

      When this setting is true, note the following:

      • You must set TargetTablePrepMode to nothing.

      • DMS automatically sets useUpdateLookup to false.

    • toBuilder

      public MongoDbSettings.Builder toBuilder()
      Description copied from interface: ToCopyableBuilder
      Take this object and create a builder that contains all of the current property values of this object.
      Specified by:
      toBuilder in interface ToCopyableBuilder<MongoDbSettings.Builder,MongoDbSettings>
      Returns:
      a builder for type T

    • builder

      public static MongoDbSettings.Builder builder()

    • serializableBuilderClass

      public static Class<? extends MongoDbSettings.Builder> serializableBuilderClass()

    • hashCode

      public final int hashCode()
      Overrides:
      hashCode in class Object

    • equals

      public final boolean equals(Object obj)
      Overrides:
      equals in class Object

    • equalsBySdkFields

      public final boolean equalsBySdkFields(Object obj)
      Description copied from interface: SdkPojo
      Indicates whether some other object is "equal to" this one by SDK fields. An SDK field is a modeled, non-inherited field in an SdkPojo class, and is generated based on a service model.

      If an SdkPojo class does not have any inherited fields, equalsBySdkFields and equals are essentially the same.

      Specified by:
      equalsBySdkFields in interface SdkPojo
      Parameters:
      obj - the object to be compared with
      Returns:
      true if the other object equals to this object by sdk fields, false otherwise.

    • toString

      public final String toString()
      Returns a string representation of this object. This is useful for testing and debugging. Sensitive data will be redacted from this string using a placeholder value.
      Overrides:
      toString in class Object

    • getValueForField

      public final <T> Optional<T> getValueForField(String fieldName, Class<T> clazz)

    • sdkFields

      public final List<SdkField<?>> sdkFields()
      Specified by:
      sdkFields in interface SdkPojo
      Returns:
      List of SdkField in this POJO. May be empty list but should never be null.