ID documento

Il formato dell'ID di un documento varia a seconda che il database sia partizionato o meno. Quando un database è partizionato, la chiave di partizione per ogni documento è definita come parte dell'ID del documento, come descritto in dettaglio nella sezione successiva.

$PARTITION_KEY:$DOCUMENT_KEY

Limitazioni dei nomi campo

I nomi dei campi che iniziano con il carattere di sottolineatura (_) sono riservati in IBM Cloudant. Questa regola significa che normalmente non è possibile avere nomi di campi propri che iniziano con un trattino basso. Ad esempio, il campo example sarebbe accettato, ma il campo _example genererebbe un messaggio doc_validation di errore.

Ecco un esempio di documento JSON che tenta di creare un campo con un prefisso trattino basso:

{
	"_top_level_field_name": "some data"
}

Visualizza un messaggio di errore che viene restituito quando si tenta di creare un campo con un prefisso trattino basso:

{
	"error": "doc_validation",
	"reason": "Bad special document member: _top_level_field_name"
}

Tuttavia, se il nome del campo si riferisce a un oggetto annidato all'interno del documento, è possibile utilizzare un prefisso con trattino basso per il nome del campo.

Ecco un esempio di documento JSON che tenta di creare un campo con un prefisso trattino basso, annidato all'interno di un oggetto:

{
	"another_top_level_field_name": "some data",
	"another_field": {
		"_lower_level_field_name": "some more data"
	}
}

Ecco un esempio di messaggio di conferma (abbreviato) visualizzato quando viene creato un campo nidificato con prefisso trattino basso:

{
	"ok": true,
	"id": "2",
	"rev": "1-9ce...8d4"
}