Hoja de referencia para DynamoDB
Esta hoja de referencia proporciona una base rápida para trabajar con Amazon DynamoDB y los distintos AWS SDK.
Configuración inicial
Obtenga una clave de acceso de AWS para acceder a DynamoDB mediante programación.
Véase también:
SDK o CLI
Elija el SDK preferido o configure la AWS CLI.
nota
Cuando se utiliza la AWS CLI en Windows, una barra invertida (\) que no esté entre comillas se considera un retorno de carro. Además, debe usar escape entre comillas y corchetes dentro de otras comillas. Para ver un ejemplo, consulte la pestaña Windows en "Create a table" (Crear una tabla) en la siguiente sección.
Véase también:
Acciones básicas
En esta sección se proporciona código para las tareas básicas de DynamoDB. Para obtener más información sobre estas tareas, consulte Introducción a DynamoDB y los AWS SDK.
Creación de una tabla
Escribir elemento en una tabla
aws dynamodb put-item \ --table-name Music \ --item file://item.json
Leer elemento de una tabla
aws dynamodb get-item \ --table-name Music \ --item file://item.json
Eliminar un elemento de una tabla
aws dynamodb delete-item --table-name Music --key file://key.json
Consultar una tabla
aws dynamodb query --table-name Music --key-condition-expression "ArtistName=:Artist and SongName=:Songtitle"
Eliminación de una tabla
aws dynamodb delete-table --table-name Music
Mostrar nombres de tablas
aws dynamodb list-tables
Reglas de nomenclatura
-
Todos los nombres se deben codificar mediante UTF-8 y distinguen entre mayúsculas y minúsculas.
-
Los nombres de las tablas y los índices deben tener entre 3 y 255 caracteres, que solo pueden ser los siguientes:
-
a-z -
A-Z -
0-9 -
_(guion bajo) -
-(guion) -
.(punto)
-
-
Los nombres de atributo deben tener al menos un carácter y un tamaño inferior a 64 KB.
Para obtener más información, consulte Naming rules (Reglas de nomenclatura).
Conceptos básicos sobre Service Quotas
Unidades de lectura y escritura
-
Unidad de capacidad de lectura (RCU): una lectura altamente coherente por segundo o dos lecturas coherentes posteriores por segundo, para elementos con un tamaño de hasta 4 KB.
-
Unidad de capacidad de escritura (WCU): una escritura por segundo para los elementos con un tamaño de hasta 1 KB.
Límites de tabla
-
Tamaño de tabla: no existe ningún límite práctico del tamaño de una tabla. Las tablas no presentan restricciones en cuanto al número de elementos o de bytes.
-
Número de tablas: para cualquier cuenta de AWS, existe una cuota inicial de 2500 tablas por región de AWS.
-
Límite de tamaño de página para consulta y análisis: hay un límite de 1 MB por página, por consulta o análisis. Si los parámetros de la consulta o la operación de análisis de una tabla arrojan más de 1 MB de datos, DynamoDB devuelve los elementos coincidentes iniciales. También devuelve una propiedad
LastEvaluatedKeyque puede utilizar en una nueva solicitud para leer la página siguiente.
Índices
-
Índices secundarios locales (LSI): puede definir un máximo de cinco índices secundarios locales. Los LSI son útiles principalmente cuando un índice debe tener una gran coherencia con la tabla base.
-
Índices secundarios globales (GSI): existe una cuota predeterminada de 20 índices secundarios globales por tabla.
-
Atributos de índice secundario proyectado por tabla: puede proyectar un máximo de 100 atributos en todos los índices secundarios locales y globales de una tabla. Esto solo se aplica a los atributos proyectados especificados por el usuario.
Claves de partición
-
La longitud mínima de un valor de clave de partición es de 1 byte. La longitud máxima es de 2048 bytes.
-
No existe ningún límite práctico respecto al número de valores diferentes de clave de partición, ni para tablas ni para los índices secundarios.
-
La longitud mínima de un valor de clave de ordenación es de 1 byte. La longitud máxima es de 1024 bytes.
-
En general, no existe ningún límite práctico respecto al número de valores diferentes de clave de ordenación por cada valor de clave de partición. Hay una excepción en las tablas que utilizan índices secundarios.
Para obtener más información sobre los índices secundarios, el diseño de la clave de partición y el diseño de la clave de clasificación, consulte Prácticas recomendadas.
Límites para los tipos de datos de uso común
-
Cadena: la longitud de una cadena está limitada por el tamaño de elemento máximo de 400 KB. Los valores de tipo String son Unicode con codificación binaria UTF-8.
-
Número: un número puede tener hasta 38 dígitos de precisión y puede ser positivo, negativo o cero.
-
Binario: la longitud de un valor binario está limitada por el tamaño de elemento máximo de 400 KB. Las aplicaciones que utilizan atributos binarios deben codificar los datos en cifrado base64 antes de enviarlos a DynamoDB.
Para obtener una lista completa de los tipos de datos admitidos, consulte Data types (Tipos de datos). Para obtener más información, consulte también Service Quotas.
Elementos, atributos y parámetros de expresión
El tamaño máximo de un elemento en DynamoDB es de 400 KB, que incluye la longitud en formato binario de los nombres de los atributos (longitud en UTF-8) y las longitudes en formato binario de los valores de los atributos (longitud en UTF-8). El nombre de los atributos se tiene en cuenta al calcular el límite de tamaño.
No existe ningún límite en el número de valores de una lista, un mapa o un conjunto, siempre y cuando el elemento que contiene los valores se ajuste al límite de tamaño de elemento de 400 KB.
Para parámetros de expresión, la longitud máxima de cualquier cadena de expresión es 4 KB.
Para obtener más información sobre el tamaño del elemento, los atributos y los parámetros de expresión, consulte Service Quotas.
Más información
