LiteDB é um banco de dados integrado NoSQL .NET nativo. .NET integrado, LiteDB é facilmente acessível para PowerShell e funciona maravilhosamente como um banco de dados local e flexível. Criptografia integrada, comandos semelhantes a SQL e compatível com ACID com suporte total a transações O LiteDB é simples e fácil de usar. Neste artigo, falaremos sobre como você pode usar o LiteDB no PowerShell e possíveis casos de uso!
Instalando LiteDB no PowerShell
Disponível como um pacote NuGet, LiteDB é facilmente instalável como um pacote usando o Install-Package cmdlet. A versão mais recente, no momento da publicação, é a versão 5.0.9, que pretendemos ser a versão mínima. Além disso, para evitar a necessidade de direitos administrativos, estamos instalando isso no CurrentUser escopo.
Install-Package -Name 'LiteDB' -MinimumVersion '5.0.9' -Source 'nuget.org' -Scope 'CurrentUser'
A seguir, vamos importar a biblioteca para uso. Você pode simplesmente usar Add-Type e apontar para o caminho da montagem, mas podemos automatizar isso.
# Test if we have already loaded the assembly by looking for the PSType of LiteDB.LiteDatabase
If ( -Not ([System.Management.Automation.PSTypeName]'LiteDB.LiteDatabase').Type ) {
# 1) Get the path of the LiteDB package using the Source
# 2) This returns the *.nupkg file, so we use Split-Path to only return the package root path
# 3) Multiple DLL's will exist, usually for .NET 4.5, .NET Standard 1.3, and .NET Standard 2.0. Locate only the .NET Standard and the latest version, in this case 2.0.
# The path will look something like: C:UsersusernameAppDataLocalPackageManagementNuGetPackagesLiteDB.5.0.9libnetstandard2.0LiteDB.dll
$standardAssemblyFullPath = (Get-ChildItem -Filter '*.dll' -Recurse (Split-Path (Get-Package -Name 'LiteDB').Source)).FullName | Where-Object {$_ -Like "*standard*"} | Select-Object -Last 1
Add-Type -Path $standardAssemblyFullPath -ErrorAction 'SilentlyContinue'
}
Agora que carregamos o módulo para uso, continue lendo para criar um novo banco de dados LiteDB na próxima seção!
Criação de um novo banco de dados LiteDB
Há vários comandos disponíveis para LiteDB, que você pode aprender aqui, mas primeiro precisamos criar um novo banco de dados. Precisamos definir o caminho onde criar o arquivo de banco de dados. Como o LiteDB cria bancos de dados de arquivo único, o banco de dados pode ser localizado em qualquer lugar. Neste caso, vamos localizar o banco de dados em nosso caminho atual e usar o nome de Test.db.
# Create the Test.db database in the current directory
$Database = [LiteDB.LiteDatabase]::New((Join-Path -Path "." -ChildPath "Test.db"))
Tenha em mente que até você ligar
$Database.Dispose()no arquivo de banco de dados, oTest.dbo arquivo permanecerá bloqueado.
Na próxima seção, criaremos uma tabela, adicionaremos um índice e criaremos um novo registro em nosso banco de dados.
Criação de uma tabela e adição de um registro no LiteDB
Semelhante às tabelas em SQL, o LiteDB usa coleções, semelhante ao MongoDB. Para este artigo, criaremos uma nova coleção chamada TestCollection, e usando GetCollection() a coleção será criada se ainda não existir.
# Retrieve the collection (i.e. table) to store our data in.
$Collection = $Database.GetCollection('TestCollection')
# Make sure that an index exists on the Name field so that queries work easier and quicker.
# To allow for named queries, such as using the Name field, we ensure an index is created.
# The result is sent to Out-Null to avoid the True console output on creation.
$Collection.EnsureIndex('Name') | Out-Null
Os índices são valiosos porque aumentam o desempenho e permitem consultas facilmente nomeadas ao pesquisar um registro. Implementados usando listas de ignorar, os índices evitam uma varredura completa e a desserialização do banco de dados toda vez que uma pesquisa é feita.
Adicionando um registro a uma coleção LiteDB
Primeiro, precisamos configurar o LiteDB.BSONMapper. Esta é a implementação de documentos do LiteDB, que armazena pares chave-valor. Primeiro criamos um mapeador que podemos analisar um objeto PowerShell em um documento que pode então ser adicionado à nossa coleção usando o Insert() método.
$BSONMapper = [LiteDB.BSONMapper]::New()
$Object = @{
"Name" = 'TestName'
"Value" = 'TestValue'
}
Try {
# Attempt to insert the object as a new collection entry.
$Collection.Insert($BSONMapper.ToDocument($Object))
} Catch {
Throw "Unable to insert item."
}
Consultando registros no LiteDB
Para consultar um objeto no LiteDB, podemos usar vários métodos diferentes, como:
FindAll()- Retorne todos os documentos de uma coleção.FindOne()- DevoluçõesFirstOrDefaultde umFind()inquerir.FindById()- DevoluçõesSingleOrDefaultResultado deFind()usando a chave primária de_idíndice.Find()- Retorne todos os documentos usando a expressão definida.
Neste exemplo, vamos consultar todos os documentos e depois apenas aquele que estamos procurando. Também podemos testar se o documento existe, usando o Exists() método. Para demonstrar isso, primeiro verificaremos se o documento existe e, em seguida, localizaremos o primeiro documento com o nome TestName e, finalmente, localize todos os documentos. Para demonstrar o último método, adicionamos um documento adicional com o mesmo nome, mas com um valor diferente.
# Test if the `TestName` document exists
$Collection.Exists("`$.Name="TestName"")
# Return the first `TestName` document found
$Collection.FindOne("`$.Name="TestName"")
# Display all documents in a collection
$Collection.FindAll()
![]()
Verifique se o documento existe, localizou o documento específico e, em seguida, todos os documentos.
Atualizando e removendo um documento
Agora que criamos um documento, vamos atualizar o valor. Isso é feito usando o nome apropriado Update() método.
$Item = $Collection.FindOne("`$.Name="TestName"")
$Item['Value'] = 'UpdatedValue'
Try {
# Attempt to update the existing document with the updated value
$Collection.Update($Item)
} Catch {
Throw "Unable to update item."
}
Claro, podemos não querer manter este documento. Portanto, podemos remover o documento usando o Remove() método. Isso exige que saibamos o ID do documento. Uma vez que já temos as informações no $Item variável, podemos alavancar o _id propriedade para remover o documento.
Try {
# Remove the entry using the _id attribute, internal to the LiteDB database
$Collection.Delete($Item['_id'].RawValue)
} Catch {
Throw "Unable to delete item."
}
Limpando o banco de dados e próximas etapas
Uma vez que o banco de dados está bloqueado quando em uso, precisamos chamar o Dispose() método para remover o bloqueio. Este é um passo importante, caso contrário, podemos acabar com a corrupção.
$Database.Dispose()
Com isso, demonstramos exemplos completos de como criar um banco de dados, criar e atualizar documentos e remover esses documentos. Existem muitos usos possíveis para o LiteDB, como um banco de dados de coleta de dados temporário em um servidor, para um sistema de armazenamento de documentos rápido e portátil que pode ser facilmente copiado. Explore o LiteDB e veja o que você pode fazer com ele hoje!



