DynamoDB协议兼容版实例支持详情

背景信息

Amazon DynamoDB是一种完全托管的NoSQL数据库服务，提供快速且可预测的性能，能够实现无缝扩展。阿里云数据库MongoDB版现在兼容了DynamoDB协议，您可以在创建云数据库MongoDB实例时选择支持DynamoDB协议即可使用DynamoDB协议。如何创建DynamoDB协议兼容版实例，请参见创建DynamoDB协议兼容版实例。

注意事项

• 仅云数据库MongoDB版4.0版本的分片集群实例支持DynamoDB协议。
• 存量实例可通过开启兼容DynamoDB协议来获取支持。
• 目前DynamoDB兼容功能仅支持在VPC环境下使用，使用时无需鉴权。

DynamoDB接口支持情况

DynamoDBStreams接口支持情况

DynamoDB接口相关数据结构

表达式支持情况

• 带.属性名的处理：一个带.的属性名可能表示一个scalar属性，也可能表示一个嵌入文档。在DynamoDB中的处理规则是：如果在表达式属性名中能够找到该属性名对应的映射，就按照scalar属性进行处理，否则按照嵌入文档进行处理。
  说明 目前暂不支持带.scalar属性的相关处理，如查询、投影等。
• ProjectionExpression： 只支持一维数组，并且当表达式中只包含数组某个元素时则会返回其他字段。
• ConditionExpression：
  • DynamoDB中的ConditionExpression语法如下：

    condition-expression ::=
          operand comparator operand
        | operand BETWEEN operand AND operand
        | operand IN ( operand (',' operand (, ...) ))
        | function
        | condition AND condition
        | condition OR condition
        | NOT condition
        | ( condition )
    
    comparator ::=
        =
        | <>
        | <
        | <=
        | >
        | >=
    
    function ::=
        attribute_exists (path)
        | attribute_not_exists (path)
        | attribute_type (path, type)
        | begins_with (path, substr)
        | contains (path, operand)
        | size (path)

  • operand1 comparator operand2语法中，operand1必须为path，operand2必须为表达式属性值。
  • operand1 BETWEEN operand2 AND operand3语法中，operand1必须为path，其余operand必须为表达式属性值。
  • operand1 IN ( operand2 (',' operand3 (, ...) ))语法中，operand1必须为path，其余operand必须为表达式属性值。
  • 对于function中的size(path)函数，只支持path字段为字符串类型（判断长度）或Set/List类型，用于判断大小，不支持Binary和Map类型。
• UpdateExpression：
  • DynamoDB中的UpdateExpression语法如下：

    update-expression ::=
        [ SET action [, action] ... ]
        [ REMOVE action [, action] ...]
        [ ADD action [, action] ... ]
        [ DELETE action [, action] ...]
    
    set-action ::=
        path = value
    
    value ::=
        operand
        | operand '+' operand
        | operand '-' operand
    
    operand ::=
        path | function
    
    function ::=
        if_not_exists (path, value)
        | list_append (list1, list2)
    
    remove-action ::=
        path
    
    add-action ::=
        path value
    
    delete-action ::=
        path value

  • set-action：
    • SET path = operand语法中，不支持operand是path的场景。
    • SET path = operand1 '+'|'-' operand2语法中，operand1必须等于path，即在此场景下只支持字段自增或自减。
    • SET path = if_not_exists (path, value)语法中，两个path必须相等，且value只能是表达式属性值。
    • SET path = if_not_exists (path, value)语法中，在同时指定多个时不支持部分更新，即需要满足全部条件才能执行成功。
    • SET path = list_append(list1, list2)语法中，list1和list2中必须有一个等于path，另外一个是表达式属性值。
  • remove-action：用于移除List中某个元素时，用null代替被移除的元素，List大小不变，剩下的元素不会发生移位。

数据类型映射说明

DynamoDB提供的数据类型和MongoDB的不同，因此，阿里云会在DynamoDB协议兼容版以及MongoDB的数据类型之间做映射，使二者相互兼容彼此的数据类型。