From 6a3cb920eeab1834d3c930c35486ac79dd25e636 Mon Sep 17 00:00:00 2001 From: Abhi Vaidyanatha Date: Fri, 14 Jan 2022 00:30:12 -0800 Subject: [PATCH] Improve clarity on namespaces documentation. (#7461) --- docs/understanding-airbyte/namespaces.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/understanding-airbyte/namespaces.md b/docs/understanding-airbyte/namespaces.md index 9c2ff5cd64ba1..3fe323cc6e1a3 100644 --- a/docs/understanding-airbyte/namespaces.md +++ b/docs/understanding-airbyte/namespaces.md @@ -6,16 +6,16 @@ The high-level overview contains all the information you need to use Namespaces when pulling from APIs. Information past that can be read for advanced or educational purposes. {% endhint %} -When looking through our connector docs, you'll notice that some sources and destinations support "Namespaces." These allow you to organize and separate your data into groups in the destination if the destination supports it. For example, in a database, a namespace could be a schema in the database. If your desired destination doesn't support it, you can ignore this feature. +When looking through our connector docs, you'll notice that some sources and destinations support "Namespaces." These allow you to organize and separate your data into groups in the destination if the destination supports it. In most cases, namespaces are schemas in the database you're replicating to. If your desired destination doesn't support it, you can ignore this feature. Note that this is the location that both your normalized and raw data will get written to. Your raw data will show up with the prefix `_airbyte_raw_` in the namespace you define. If you don't enable basic normalization, you will only receive the raw tables. If only your destination supports namespaces, you have two simple options. **This is the most likely case**, as all HTTP APIs currently don't support Namespaces. -1. Replicate to the default namespace in the destination, which will differ based on your destination. -2. Create a "Custom Format" to rename the namespace that your data will be replicated into. +1. Mirror Destination Settings - Replicate to the default namespace in the destination, which will differ based on your destination. +2. Custom Format - Create a "Custom Format" to rename the namespace that your data will be replicated into. -If both your desired source and destination support namespaces, your use case is probably replication-focused and more advanced, so continue reading. +If both your desired source and destination support namespaces, you're likely using a more advanced use case with a database as a source, so continue reading. ## What is a Namespace?