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:
- Serialized Form
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static interfaceMongoDbSettings.Builder
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description AuthMechanismValueauthMechanism()The authentication mechanism you use to access the MongoDB source endpoint.StringauthMechanismAsString()The authentication mechanism you use to access the MongoDB source endpoint.StringauthSource()The MongoDB database name.AuthTypeValueauthType()The authentication type you use to access the MongoDB source endpoint.StringauthTypeAsString()The authentication type you use to access the MongoDB source endpoint.static MongoDbSettings.Builderbuilder()StringdatabaseName()The database name on the MongoDB source endpoint.StringdocsToInvestigate()Indicates the number of documents to preview to determine the document organization.booleanequals(Object obj)booleanequalsBySdkFields(Object obj)StringextractDocId()Specifies the document ID.<T> Optional<T>getValueForField(String fieldName, Class<T> clazz)inthashCode()StringkmsKeyId()The KMS key identifier that is used to encrypt the content on the replication instance.NestingLevelValuenestingLevel()Specifies either document or table mode.StringnestingLevelAsString()Specifies either document or table mode.Stringpassword()The password for the user account you use to access the MongoDB source endpoint.Integerport()The port value for the MongoDB source endpoint.BooleanreplicateShardCollections()Iftrue, DMS replicates data to shard collections.Map<String,SdkField<?>>sdkFieldNameToField()List<SdkField<?>>sdkFields()StringsecretsManagerAccessRoleArn()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 inSecretsManagerSecret.StringsecretsManagerSecretId()The full ARN, partial ARN, or friendly name of theSecretsManagerSecretthat contains the MongoDB endpoint connection details.static Class<? extends MongoDbSettings.Builder>serializableBuilderClass()StringserverName()The name of the server on the MongoDB source endpoint.MongoDbSettings.BuildertoBuilder()StringtoString()Returns a string representation of this object.Stringusername()The user name you use to access the MongoDB source endpoint.BooleanuseUpdateLookUp()Iftrue, DMS retrieves the entire document from the MongoDB source during migration.-
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface software.amazon.awssdk.utils.builder.ToCopyableBuilder
copy
-
-
-
-
Method Detail
-
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,
authTypewill returnAuthTypeValue.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromauthTypeAsString().- 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:
AuthTypeValue
-
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,
authTypewill returnAuthTypeValue.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromauthTypeAsString().- 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:
AuthTypeValue
-
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 whenAuthTypeis set to"no".If the service returns an enum value that is not available in the current SDK version,
authMechanismwill returnAuthMechanismValue.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromauthMechanismAsString().- 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 whenAuthTypeis set to"no". - See Also:
AuthMechanismValue
-
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 whenAuthTypeis set to"no".If the service returns an enum value that is not available in the current SDK version,
authMechanismwill returnAuthMechanismValue.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromauthMechanismAsString().- 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 whenAuthTypeis set to"no". - See Also:
AuthMechanismValue
-
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,
nestingLevelwill returnNestingLevelValue.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromnestingLevelAsString().- 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:
NestingLevelValue
-
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,
nestingLevelwill returnNestingLevelValue.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromnestingLevelAsString().- 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:
NestingLevelValue
-
extractDocId
public final String extractDocId()
Specifies the document ID. Use this setting when
NestingLevelis set to"none".Default value is
"false".- Returns:
- Specifies the document ID. Use this setting when
NestingLevelis 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
NestingLevelis set to"one".Must be a positive value greater than
0. Default value is1000.- Returns:
- Indicates the number of documents to preview to determine the document organization. Use this setting
when
NestingLevelis set to"one".Must be a positive value greater than
0. Default value is1000.
-
authSource
public final String authSource()
The MongoDB database name. This setting isn't used when
AuthTypeis set to"no".The default is
"admin".- Returns:
- The MongoDB database name. This setting isn't used when
AuthTypeis 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
KmsKeyIdparameter, 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
KmsKeyIdparameter, 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 theiam:PassRoleaction.SecretsManagerSecrethas 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 forUserName,Password,ServerName, andPort. You can't specify both. For more information on creating thisSecretsManagerSecretand theSecretsManagerAccessRoleArnandSecretsManagerSecretIdrequired 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 theiam:PassRoleaction.SecretsManagerSecrethas 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 forUserName,Password,ServerName, andPort. You can't specify both. For more information on creating thisSecretsManagerSecretand theSecretsManagerAccessRoleArnandSecretsManagerSecretIdrequired 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
SecretsManagerSecretthat contains the MongoDB endpoint connection details.- Returns:
- The full ARN, partial ARN, or friendly name of the
SecretsManagerSecretthat 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 tofalse.- 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 tofalse.
-
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
TargetTablePrepModetonothing. -
DMS automatically sets
useUpdateLookuptofalse.
- 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
TargetTablePrepModetonothing. -
DMS automatically sets
useUpdateLookuptofalse.
-
-
-
toBuilder
public MongoDbSettings.Builder toBuilder()
- Specified by:
toBuilderin interfaceToCopyableBuilder<MongoDbSettings.Builder,MongoDbSettings>
-
builder
public static MongoDbSettings.Builder builder()
-
serializableBuilderClass
public static Class<? extends MongoDbSettings.Builder> serializableBuilderClass()
-
equalsBySdkFields
public final boolean equalsBySdkFields(Object obj)
- Specified by:
equalsBySdkFieldsin interfaceSdkPojo
-
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.
-
sdkFieldNameToField
public final Map<String,SdkField<?>> sdkFieldNameToField()
- Specified by:
sdkFieldNameToFieldin interfaceSdkPojo
-
-