Autorização no Cosmos DB no Microsoft Fabric

O Cosmos DB no Microsoft Fabric depende principalmente da autenticação do Microsoft Entra ID e das funções internas do plano de dados para gerenciar a autenticação e a autorização. Neste guia, você configura funções embutidas do plano de dados para um banco de dados Cosmos DB no Fabric. Você pode configurar o acesso ao seu Cosmos DB usando funções de espaço de trabalho nos controles de acesso do Microsoft Fabric.

Os controles de acesso em dois níveis diferentes funcionam juntos. Por exemplo, para se conectar a um banco de dados, um usuário deve ter pelo menos a permissão de leitura no item de banco de dados do Fabric.

Controles de acesso

No Fabric, você controla o acesso usando funções de workspace do Fabric. As funções de workspace do Fabric gerenciam quem pode fazer o que em um workspace do Microsoft Fabric.

Primeiro, o Cosmos DB no Fabric tem permissões de nível de item com três funções bem definidas:

	Capacidade
Leia	Conectar-se ao banco de dados, ler itens, consultar itens, ler feed de alterações, listar contêineres, ler a taxa de transferência e ler metadados
ReadAll	Mesma funcionalidade de Leitura e, além disso, ler dados espelhados diretamente de arquivos do OneLake
Escrever	Mesma funcionalidade do ReadAll e, além disso, criar contêiner, excluir contêiner, criar item, excluir item, modificar item

As funções do workspace no Fabric se traduzem nas seguintes permissões de nível de item para itens no Cosmos DB do Fabric:

	Administrador	Membro	Contribuidor	Visualizador
Leia	✅ Sim	✅ Sim	✅ Sim	✅ Sim
ReadAll	✅ Sim	✅ Sim	✅ Sim	✅ Sim
Escrever	✅ Sim	✅ Sim	✅ Sim	✖️ Não

Sob outra perspectiva, esta tabela identifica as capacidades comuns que seus usuários podem exigir com o banco de dados Cosmos DB e as mapeia para a função de workspace correta.

	Administrador	Membro	Contribuidor	Visualizador
Acesso administrativo total e acesso total aos dados	✅ Sim	✅ Sim	✅ Sim	✖️ Não
Leia dados e metadados	✅ Sim	✅ Sim	✅ Sim	✅ Sim
Conectar-se ao banco de dados	✅ Sim	✅ Sim	✅ Sim	✅ Sim

Dica

Para obter mais informações sobre como as funções funcionam em workspaces, consulte Funções em workspaces. Para obter mais informações sobre como atribuir funções de workspace, consulte Conceder aos usuários acesso a workspaces.

Mapeamento para o Azure

Se você tiver experiência com o Azure Cosmos DB para NoSQL, poderá mapear as permissões de item do Cosmos DB no Fabric para as funções internas do plano de dados do serviço:

As permissões de itens do banco de dados do Cosmos DB são comparáveis às seguintes atribuições de funções relacionadas ao plano de dados, no escopo do banco de dados do Azure Cosmos DB.

	Função do Azure Cosmos DB para NoSQL	Scope
Leia	Cosmos DB Built-in Data Reader	Base de dados
ReadAll	Cosmos DB Built-in Data Reader	Base de dados
Escrever	Cosmos DB Built-in Data Contributor	Base de dados

Ou, se preferir, você pode mapear para as permissões de controle de acesso baseadas em função do Azure:

	Função do Azure Cosmos DB para NoSQL	Scope
Leia	[ "Microsoft.DocumentDB/databaseAccounts/readMetadata", "Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers/items/read", "Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers/executeQuery", "Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers/readChangeFeed" ]	Base de dados
ReadAll	[ "Microsoft.DocumentDB/databaseAccounts/readMetadata", "Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers/items/read", "Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers/executeQuery", "Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers/readChangeFeed" ]	Base de dados
Escrever	[ "Microsoft.DocumentDB/databaseAccounts/readMetadata", "Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers/*", "Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers/items/*" ]	Base de dados

Observação

Para obter mais informações sobre as funções do Azure Cosmos DB para NoSQL, consulte a segurança do plano de dados do Azure Cosmos DB para NoSQL.

Conteúdo relacionado

• Saiba mais sobre o Cosmos DB no Microsoft Fabric
• Autenticar o Cosmos DB no Microsoft Fabric