/ /

Compatibilidade de recursos

Visão geral

Nesta página, você pode encontrar informações sobre os recursos compatíveis e não suportados na extensão Hibername ORM. A extensão Hibernate ORM tem suporte apenas a conjuntos de réplicas MongoDB. Quando você usa um recurso não suportado, a extensão ORM do Hibername lança um UnsupportedFeatureException.

Você também pode encontrar os recursos atualmente planejados para futuras versões nesta página. Priorizaremos essas funcionalidades futuras com base na demanda do usuário, e você pode solicitar suporte para uma funcionalidade criando uma ideia da AHA.

A extensão do MongoDB para hibernação ORM está atualmente em visualização pública. A visualização pública não é recomendada para implantações de produção, pois alterações interruptivas podem ser introduzidas.

Funcionalidades do MongoDB

Esta seção indica se a extensão Hibernar ORM é compatível com várias funcionalidades do MongoDB .

Suporte ao tipo de dados

Para ver uma lista de todos os BSON types suportados na extensão Hibernate ORM, consulte a seção MongoDB BSON Fields no guia Criar Entidades.

Suporte a consultas

Funcionalidade do MongoDB	Suporte à visualização pública	Suporte de disponibilidade geral (GA)
Gravações em massa	✓	✓
Excluir operações	✓	✓
Consultas geoespaciais	Não compatível. No entanto, o método `createNativeQuery()` oferece suporte a queries geoespaciais. Inclua o estágio de pipeline `$geoWithin` ou `$near` em sua declaração de linguagem de query do MongoDB . Para saber mais sobre queries nativas, consulte o guia Executar Queries Nativas de Banco de Dados.	Estamos considerando esse recurso para a versão GA.
Inserir operações	✓	✓
Queries de pesquisa MongoDB	Não compatível. No entanto, o método `createNativeQuery()` suporta queries de pesquisa. Inclua o estágio do pipeline `$search` em sua declaração de linguagem de query do MongoDB . Para exibir um exemplo, consulte a seção Executar uma query de pesquisa do MongoDB no guia Executar queries nativas de banco de dados.	Estamos considerando esse recurso para a versão GA.
Queries do MongoDB Vector Search	Não compatível. No entanto, o método `createNativeQuery()` tem suporte para consultas de query de pesquisa vetorial. Inclua o estágio do pipeline `$vectorSearch` em sua declaração de linguagem de query do MongoDB . Para saber mais sobre queries nativas, consulte o guia Executar Queries Nativas de Banco de Dados.	Estamos considerando esse recurso para a versão GA.
Query nativa com MQL	Parcialmente suportado. A vinculação de parâmetros não é suportada.	✓
Projeções	Parcialmente suportado. Expressões de aggregation dentro de projeções de query não são suportadas, e você deve incluir todos os campos de entidade em sua projeção.	Parcialmente suportado. Aplicam-se as mesmas limitações de expressão de agregação e campo de entidade.
Ler operações	✓	✓
Atualizar operações	✓	✓
Operações upsert	Não compatível. No entanto, você pode primeiro fazer query da coleção para verificar se o valor especificado existe e, em seguida, inserir ou atualizar se o valor existe.	Estamos considerando esse recurso para a versão GA.

Suporte a banco de dados e collection

Funcionalidade do MongoDB	Suporte à visualização pública	Suporte de disponibilidade geral (GA)
Fluxos de alterações	Não compatível. No entanto, você pode usar o driver Java do MongoDB para definir uma instância `MongoClient`. Em seguida, use o método `MongoClient.watch()` para abrir um fluxo de alteração.	Estamos considerando esse recurso para a versão GA.
Criptografia no nível do campo do lado do cliente (CSFLE) e Queryable Encryption (QE)	Não compatível. No entanto, você pode configurar o CSFLE/QE ao configurar o driver Java do MongoDB .	Estamos considerando esse recurso para a versão GA.
GridFS	Não compatível. No entanto, você pode usar o driver Java do MongoDB para definir uma instância `MongoClient`. Em seguida, chame o método `GridFSBuckets.create()` com uma instância `MongoDatabase` como parâmetro para instanciar um GridFSBucket.	Estamos considerando esse recurso para a versão GA.
Dados de Time Series	Não compatível. No entanto, você pode usar o driver Java do MongoDB para definir uma instância `MongoClient`. Em seguida, crie uma nova coleção com `timeSeriesOptions()` especificado para criar uma coleção de séries temporais.	Estamos considerando esse recurso para a versão GA.
Instâncias standalone `mongod`	Não compatível. Recomendamos que você converta quaisquer instâncias autônomo em um conjunto de réplicas. Para saber mais, consulte Converter um mongod autônomo autogerenciado em um conjunto de réplicas no manual do MongoDB Server.	Estamos considerando esse recurso para a versão GA.
Visualizações	Não compatível. No entanto, você pode usar o driver Java do MongoDB para definir uma instância `MongoClient`. Em seguida, chame o método `createView()` na sua instância do `MongoDatabase` para criar uma nova visualização.	Estamos considerando esse recurso para a versão GA.

Transações e simultaneidade

Funcionalidade do MongoDB	Suporte à visualização pública	Suporte de disponibilidade geral (GA)
Bloqueio	Parcialmente suportado. O bloqueio otimista é suportado.	Estamos considerando esse recurso para a versão GA.
Transações	✓	✓

Mapeamento e suporte a modelos

Funcionalidade do MongoDB	Suporte à visualização pública	Suporte de disponibilidade geral (GA)
Associações	Não compatível.	✓
IDs de geração automática	Parcialmente suportado. A geração automática de ObjectIds é compatível. No entanto, você pode definir manualmente um UUID.	Estamos considerando esse recurso para a versão GA.
Estratégia de herança	Não compatível.	✓
Busca preguiçosa/ansiosa	Não compatível.	Não compatível.
Encomenda	✓	✓
Validação	✓	✓

Suporte ao índice

Funcionalidade do MongoDB	Suporte à visualização pública	Suporte de disponibilidade geral (GA)
Capped collections	Não compatível. No entanto, você pode usar o driver Java do MongoDB para definir uma instância `MongoClient`. Em seguida, crie uma coleção limitada especificando `CreateCollectionOptions.capped(true)` como um parâmetro em sua chamar `createCollection()`.	Estamos considerando esse recurso para a versão GA.
Clustered Collections	Não compatível. No entanto, você pode usar o driver Java do MongoDB para definir uma instância `MongoClient`. Em seguida, crie um documento chamado `clusteredIndex` e defina seu índice agrupado. Use esse índice clusterizado como parte do documento que você passa para o método `MongoDatabase.runCommand()`, que define a coleção clusterizada.	Estamos considerando esse recurso para a versão GA.
Índices compostos	Não compatível. No entanto, você pode usar o driver Java do MongoDB para definir uma instância `MongoClient`. Em seguida, chame o método aninhado `MongoCollection.createIndex(Indexes.compoundIndex())` para criar um índice composto.	Estamos considerando esse recurso para a versão GA.
Índices de documento incorporados	Não compatível. No entanto, você pode usar o driver Java do MongoDB para definir uma instância `MongoClient`. Em seguida, chame o método aninhado `MongoCollection.createIndex(Indexes.ascending("field.subfield"))`. Este método utiliza caminhos de chave aninhados "campo.subfield" para criar um índice de documento incorporado .	Estamos considerando esse recurso para a versão GA.
Índices geoespaciais	Não compatível. No entanto, você pode usar o driver Java do MongoDB para definir uma instância `MongoClient`. Em seguida, chame o método aninhado `MongoCollection.createIndex(geo2dsphere("location"))` para criar um índice geoespacial no campo `location`.	Estamos considerando esse recurso para a versão GA.
Índices de pesquisa do MongoDB	Não compatível. No entanto, você pode usar o driver Java do MongoDB para definir uma instância `MongoClient`. Em seguida, chame o método `MongoCollection.createSearchIndex()` para criar um índice de pesquisa.	Estamos considerando esse recurso para a versão GA.
Índices de pesquisa MongoDB Vector Search	Não compatível. No entanto, você pode usar o driver Java do MongoDB para definir uma instância `MongoClient`. Em seguida, chame o método `MongoCollection.createSearchIndexes()` com um tipo `vector` `SearchIndexModel` para criar um índice de pesquisa vetorial do MongoDB.	Estamos considerando esse recurso para a versão GA.
Índices multichave	Não compatível. Use o comportamento padrão do MongoDB para campos de array.	Estamos considerando esse recurso para a versão GA.
Índices parciais	Não compatível. No entanto, você pode usar o driver Java do MongoDB para definir uma instância `MongoClient`. Em seguida, chame o método aninhado `MongoCollection.createIndex(Indexes.partialFilterExpression())` para criar um índice parcial.	Estamos considerando esse recurso para a versão GA.
Validação de esquema	Não compatível. No entanto, você pode usar o driver Java do MongoDB para definir uma instância `MongoClient`. Em seguida, crie um validador executando o comando `collMod` pelo método `MongoDatabase.runCommand()`.	Estamos considerando esse recurso para a versão GA.
Índices de campo único	Não compatível. No entanto, você pode usar o driver Java do MongoDB para definir uma instância `MongoClient`. Em seguida, chame o método aninhado `MongoCollection.createIndex(Indexes.ascending("field"))` para criar um único índice de campo em ordem crescente no campo `field`.	Estamos considerando esse recurso para a versão GA.
Índices esparsos	Não compatível. No entanto, você pode usar o driver Java do MongoDB para definir uma instância `MongoClient`. Em seguida, especifique `IndexOptions().sparse(true)` como um parâmetro em sua chamar para o método `MongoCollection.createIndex()` para criar um sparse index.	Estamos considerando esse recurso para a versão GA.
Unique indexes	Não compatível. No entanto, você pode usar o driver Java do MongoDB para definir uma instância `MongoClient`. Em seguida, especifique `IndexOptions().unique(true)` como um parâmetro em sua chamar para o método `MongoCollection.createIndex()` para criar um sparse index.	Estamos considerando esse recurso para a versão GA.
Atualização de índices de modelo incorporados após a criação do modelo	Não compatível. No entanto, você pode descartar e recriar o índice do modelo incorporado manualmente.	Estamos considerando esse recurso para a versão GA.

Recursos ORM do Hibernar

Esta seção indica se a extensão Hibernar ORM oferece suporte a vários recursos do Hibernado ORM.

Suporte ao tipo de dados

Tipo de Dados	Suporte à visualização pública	Suporte de disponibilidade geral (GA)
Tipos de coleção (List, Set, Maps, arrays)	✓. `@ElementCollection` e `CollectionTable` não são suportados. No entanto, as collections de estruturas incorporadas são suportadas por meio de classes encapsuladas anotadas com `@Embeddable` e `@Struct`.	✓. As mesmas limitações do `@ElementCollection` e `CollectionTable` se aplicam.
Entidades incorporáveis, tipos escalares	Parcialmente suportado. O `java.time.Instant` tipo é suportado para entidades de nível superior e aninhadas.	Parcialmente suportado. O `java.time.Instant` tipo é suportado para entidades de nível superior e aninhadas.
Entidades incorporadas, binárias	✓	✓
Entidades incorporadas, tipos de identificador	Parcialmente suportado. Defina manualmente o ID de uma entidade antes de persistir uma entidade.	Estamos considerando esse recurso para a versão GA.
Entidades Incorporadas, JSON	✓	✓
Entidades incorporadas, semântica nula	✓	✓
Entidades de nível superior, binários	✓	✓
Entidades de nível superior, tipos de identificador	✓ Atribua manualmente UUIDs antes de persistir uma entidade.	✓ Atribua manualmente UUIDs antes de persistir uma entidade.
Entidades de nível superior, JSON	✓	✓
Entidades de nível superior, semântica nula	✓	✓
Entidades de nível superior, tipos escalares	✓	✓
Entidades de nível superior, tipos temporais	Parcialmente suportado. O `java.time.Instant` tipo é suportado para entidades de nível superior e aninhadas.	Parcialmente suportado. O `java.time.Instant` tipo é suportado para entidades de nível superior e aninhadas.
Lógica ternária (verdadeiro, falso ou DESCONHECIDO)	Não suportado.	Planejado.

Suporte a consultas

Funcionalidade ORM do Hibernar	Suporte à visualização pública	Suporte de disponibilidade geral (GA)
queries HQL e JPQL, operadores agregados	Não compatível. No entanto, o método `createNativeQuery()` oferece suporte a operadores agregados. Inclua o operador em sua declaração de linguagem de query do MongoDB . Para saber mais sobre queries nativas, consulte o guia Executar queries de banco de dados nativas.	Planejado.
Queries HQL e JPQL, operadores aritméticos	Não compatível. No entanto, o método `createNativeQuery()` suporta operadores aritméticos. Para exibir um exemplo, consulte a seção Usar operadores aritméticos no guia Executar query de banco de dados nativo.	Estamos considerando esse recurso para a versão GA.
Queries HQL e JPQL, operadores de array	✓	✓
queries HQL e JPQL, operadores de comparação	Parcialmente suportado. Os `LIKE` `BETWEENINEXISTS`operadores,,,,, `ANY` `ALL`e `IS NULL` não são aceitos no momento. No entanto, você pode usar o `createNativeQuery()` método e passar operadores de comparação em sua declaração de linguagem de query do MongoDB . Para saber mais sobre queries nativas, consulte o guia Executar queries de banco de dados nativas.	Planejado.
Queries HQL e JPQL, operadores de elementos	✓	✓
Queries HQL e JPQL, operadores de avaliação	Não compatível. No entanto, o método `createNativeQuery()` oferece suporte a operadores de avaliação. Inclua o operador em sua declaração de linguagem de query do MongoDB . Para saber mais sobre queries nativas, consulte o guia Executar queries de banco de dados nativas.	Planejado.
Queries HQL e JPQL, JUNTAS	Não compatível. No entanto, você pode usar o método `createNativeQuery()` para executar uma operação de agregação que query múltiplas coleções. Para saber mais sobre queries nativas, consulte o guia Executar queries de banco de dados nativas.	Planejado.
queries HQL e JPQL, operadores lógicos	✓	✓

Suporte a banco de dados e collection

Funcionalidade ORM do Hibernar	Suporte à visualização pública	Suporte de disponibilidade geral (GA)
Cache de primeiro nível	✓	✓
Cache de segundo nível	✓	✓

Suporte a framework e bibliotecas

Esta seção indica se a extensão Hibernate ORM suporta vários frameworks ou bibliotecas externas.

Framework ou Library	Suporte à visualização pública	Suporte de disponibilidade geral (GA)
Inicialização de primavera e dados de primavera	Parcialmente suportado. Não garantimos suporte para todos os recursos do Spring Boot ou Spring Data. Veja o aplicativo Spring Data with MongoDB Hibernar para obter um exemplo de um aplicativo feito com a extensão ORM do Hibername e Spring Data.	Parcialmente suportado. Não garantimos suporte para todos os recursos do Spring Boot ou Spring Data. Veja o aplicativo Spring Data with MongoDB Hibernar para obter um exemplo de um aplicativo feito com a extensão ORM do Hibername e Spring Data.

Voltar

Transações e sessões

Problemas e ajuda