Skip to content

Commit

Permalink
Improve clarity on namespaces documentation. (#7461)
Browse files Browse the repository at this point in the history
  • Loading branch information
avaidyanatha authored Jan 14, 2022
1 parent 15cd088 commit 6a3cb92
Showing 1 changed file with 4 additions and 4 deletions.
8 changes: 4 additions & 4 deletions docs/understanding-airbyte/namespaces.md
Original file line number Diff line number Diff line change
Expand Up @@ -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?

Expand Down

0 comments on commit 6a3cb92

Please sign in to comment.