Search for a command to run...
I used to be a .NET developer. Nowaways, I am a DevOps solutions architect with a focus on Azure and Kubernetes.
I also love productivity topics, especially when it comes to doing more with less of my time. I'm also a daddy, so time is a limited resource for me.
No comments yet. Be the first to comment.
I'm going to share all my secrets with you
Using a pull-request workflow
This is the guide I wish I had
Connecting your GitHub Workflows to Azure AD using OpenID Connect
In this post, I’ll walk through the essentials of configuring an AKS cluster to use Argo CD with an NGINX Ingress Controller. Pre-Requisites You’ll need: An AKS cluster. Here’s a Gist I use to create a simple cluster. Helm 3 Azure CLI A Custom DNS/A...
For the last 3 years, I’ve been using RavenDB in various projects. Most have been really positive experiences, but like any other technology, there’s going to be gotchas. Here’s a random collection of lessons learned from my point of view.
Sometimes we get lazy, and we do something like this:
public class BirdRepository : IRepository<Bird>
{
public IEnumerable<Bird> GetAll()
{
return _documentSession.Query<Bird>().ToList();
}
}
Let’s say that IRepository<Bird> forces us to implement a GetAll() method. Our implementation is trying to load all the documents into memory because that’s how we defined the interface.
Some time later, you might notice that although you have 200+ documents, you’re always getting 128 results from your query. This is because RavenDB is built to be safe-by-default, i.e. it won’t let you boil the ocean and load all the documents into memory.
Similarly, if you try to by-pass the aforementioned limit by doing a Take(1000) or even worse Take(int.Max), Raven will only give you 1024 documents because this is the limit on the server side. In other circumstances, you might have a transformer that’s trying to group results and take a count. Grouping data in a transformer is allowed only up to this limit. Captain Obvious: grouping data from a transformer is allowed for the sake of transformation and not for aggregation.
When first using RavenDB, one of my first challenges was trying to make Web API routing and Raven IDs work nicely together.
For instance, when attempting to build a route to GET a resource by ID:
GET api/birds/{id}
If ID is birds/1, the Web API router won’t be able to find the matching controller action.
Your first instinct might be try to use int or Guid IDs in your raven documents. But resist this urge. There’s a simpler way. Just change the convention for the identity separator.
documentStore.Conventions.IdentityPartsSeparator = "-";
Tada! Everything else should fall in place. No special code or side effects later on.
The RavenDB documentation on this topic is quite helpful. There’s a couple of strategies on how you can store polymorphic data in RavenDB.
Similar to how Entity Framework does it, you can store the entities separately or together.
public class Birds_ByName : AbstractMultiMapIndexCreationTask
{
public Birds_ByName()
{
AddMap<Owl>(owls => from o in owls select new { o.Name });
AddMap<Eagle>(dogs => from e in eagles select new { e.Name });
}
}
Then you can query all birds:
IList<Bird> results = session
.Query<Bird, Birds_ByName>()
.Where(x => x.Name == "Bald")
.ToList();
documentStore.Conventions.FindTypeTagName = type =>
{
if (typeof(Bird).IsAssignableFrom(type))
return "Birds";
return DocumentConvention.DefaultTypeTagName(type);
}
With this convention, all the documents that extend Bird will be stored as part of the same collection. All queries and indexes will be against the new tag name.
For instance, an Owl document will be indexed by:
from animal in docs.Birds
select new { animal.Name }
Won’t happen in most applications, but if you have limited resources on your RavenDB host and you expect a very large document collection (1 million+ documents), you might consider not storing the index results in memory.
You can toggle this feature right from the index definition.
public class Birds_ByName : AbstractIndexCreationTask<Bird>
{
public Birds_ByName()
{
// Map Function Here
DisableInMemoryIndexing = true;
}
}