# Define input data using an ID namespace
<a name="id-namespace"></a>

An *ID namespace* is a wrapper around your input data table. You use an ID namespace to provide metadata explaining your input data and matching techniques and how to use them in an [ID mapping workflow](create-id-mapping-workflow.md).

There are two types of ID namespaces: **Source** and **Target**.
+ The **Source** contains configurations for the source data that AWS Entity Resolution processes in an ID mapping workflow.
+ The **Target** contains a configuration of the target data that all sources resolve to.

You can define the input data that you want to resolve across two AWS accounts in an ID mapping workflow. One participant creates an ID namespace source and another participant creates an ID namespace target. After the participants create the source and target, you can run an ID mapping workflow to translate the data from the source to the target.

The following diagram summarizes how to create an ID namespace to use in an ID mapping workflow.

![\[A summary of the four steps to create an ID namespace in AWS Entity Resolution\]](http://docs.aws.amazon.com/entityresolution/latest/userguide/images/HIW-ID-Namespace.png)

The following sections describe how to create an ID namespace source and an ID namespace target. 

**Topics**
+ [ID namespace source](create-id-namespace-source.md)
+ [ID namespace target](create-id-namespace-target.md)
+ [Editing an ID namespace](edit-id-namespaces.md)
+ [Deleting an ID namespace](delete-id-namespace.md)
+ [Adding or updating a resource policy for an ID namespace](add-update-resource-policy-id-namespace.md)

# ID namespace source
<a name="create-id-namespace-source"></a>

The *ID namespace source* is the source of the data in an [ID mapping workflow](create-id-mapping-workflow.md).

Before you create an ID namespace source you must first create a schema mapping or a matching workflow, depending on your use case. For more information, see [Creating a schema mapping](create-schema-mapping.md) and [Match input data using a matching workflow](create-matching-workflow.md).

After you create an ID namespace source, you can use it along with an ID namespace target in an ID mapping workflow. For more information, see [Map input data using an ID mapping workflow](create-id-mapping-workflow.md).

There are two ways to create an ID namespace source in the AWS Entity Resolution console: the [rule-based method](create-id-namespace-source-rule-based.md) or the [provider services method](create-id-namespace-source-provider-services.md).

**Topics**
+ [Creating an ID namespace source (rule-based)](create-id-namespace-source-rule-based.md)
+ [Creating an ID namespace source (provider services)](create-id-namespace-source-provider-services.md)

# Creating an ID namespace source (rule-based)
<a name="create-id-namespace-source-rule-based"></a>

This topic describes the process of creating an ID namespace source using the **rule-based** method. This method uses matching rules to translate first-party data from a source to a target in an ID mapping workflow.

**Note**  
If the input data is the source, then it must have a schema mapping and an associated AWS Glue database.

**To create an ID namespace source (rule-based)**

1. Sign in to the AWS Management Console and open the AWS Entity Resolution console at [https://console.aws.amazon.com/entityresolution/](https://console.aws.amazon.com/entityresolution/).

1. In the left navigation pane, under **Data preparation**, choose **ID namespaces**.

1. On the **ID namespaces** page, in the upper right corner, choose **Create ID namespace**.

1. For **Details**, do the following:

   1. For **ID namespace name**, enter a unique name.

   1. (Optional) For **Description**, enter an optional description.

   1. For **ID namespace type**, choose **Source**.

1. For the **ID namespace method**, choose **Rule-based**.

1. For **Data input**, choose the **Input type** that you want to use and then take the recommended actions.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/entityresolution/latest/userguide/create-id-namespace-source-rule-based.html)

1. For **Rule parameters**, do the following.

   1. Specify the **Rule controls** by choosing one of the following options based on your goal.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/entityresolution/latest/userguide/create-id-namespace-source-rule-based.html)

      **Rule controls** must be compatible between the source and the target to be used in an ID mapping workflow. For example, if a source ID namespace limits rules to the target but the target ID namespace limits rules to the source, this results in an error.

   1. Specify the **Matching rules** by choosing one of the following options based on your data input type.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/entityresolution/latest/userguide/create-id-namespace-source-rule-based.html)

1. For **Comparison and matching parameters**, do the following.

   1. Specify the **Comparison type** by choosing one of the following options based on your goal.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/entityresolution/latest/userguide/create-id-namespace-source-rule-based.html)

   1. Specify the **Record matching type** by choosing one of the following options based on your goal.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/entityresolution/latest/userguide/create-id-namespace-source-rule-based.html)
**Note**  
You must specify compatible limitations for the source and target ID namespaces. For example, if a source ID namespace limits rules to the target but the target ID namespace limits rules to the source, this results in an error.

1. Specify the **Service access permissions** by choosing an **Existing service role name** from the dropdown list.

1. (Optional) To enable **Tags** for the resource, choose **Add new tag**, and then enter the **Key** and **Value** pair.

1. Choose **Create ID namespace**.

 The ID namespace source is created. You are now ready to [create an ID namespace target](create-id-namespace-target.md).

# Creating an ID namespace source (provider services)
<a name="create-id-namespace-source-provider-services"></a>

This topic describes the process of creating an ID namespace source using the **Provider services** method. This method uses a provider service called LiveRamp. LiveRamp translates third-party encoded data from a source to a target during an ID mapping workflow. 

**Note**  
If the input data is the source, then it must have a schema mapping and an associated AWS Glue database.

**To create an ID namespace source (provider services)**

1. Sign in to the AWS Management Console and open the AWS Entity Resolution console at [https://console.aws.amazon.com/entityresolution/](https://console.aws.amazon.com/entityresolution/).

1. In the left navigation pane, under **Data preparation**, choose **ID namespaces**.

1. On the **ID namespaces** page, in the upper right corner, choose **Create ID namespace**.

1. For **Details**, do the following:

   1. For **ID namespace name**, enter a unique name.

   1. (Optional) For **Description**, enter an optional description.

   1. For **ID namespace type**, choose **Source**.

1. For the **ID namespace method**, choose **Provider services**.
**Note**  
AWS Entity Resolution currently offers the LiveRamp provider service as an ID namespace method. If you have a subscription to LiveRamp, then the status appears as **Subscribed**. For more information about how to subscribe to LiveRamp, see [Step 1: Subscribe to a provider service on AWS Data Exchange](prepare-third-party-input-data.md#subscribe-provider-service).

1. For **Data input**, choose the **AWS Region**, **AWS Glue database**, the **AWS Glue table**, and the **Schema mapping** from the dropdown list.

   You can add up to 20 data inputs.

1. To specify the **Service access** permissions, choose an option and take the recommended action.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/entityresolution/latest/userguide/create-id-namespace-source-provider-services.html)

1. (Optional) To enable **Tags** for the resource, choose **Add new tag**, and then enter the **Key** and **Value** pair.

1. Choose **Create ID namespace**.

 The ID namespace source is created. You are now ready to [create an ID namespace target](create-id-namespace-target.md).

# ID namespace target
<a name="create-id-namespace-target"></a>

The *ID namespace target* is the target of the data in an [ID mapping workflow](create-id-mapping-workflow.md). All sources resolve to the target.

Before you create an ID namespace target you must first create a matching workflow or have a subscription to a provider service (LiveRamp), depending on your use case. For more information, see [Match input data using a matching workflow](create-matching-workflow.md) and [Step 1: Subscribe to a provider service on AWS Data Exchange](prepare-third-party-input-data.md#subscribe-provider-service).

After you create an ID namespace target, you can use it along with an ID namespace source in an ID mapping workflow. For more information, see [Map input data using an ID mapping workflow](create-id-mapping-workflow.md).

There are two ways to create an ID namespace target in the AWS Entity Resolution console: the [rule-based method](create-id-namespace-target-rule-based.md) or the [provider services method](create-id-namespace-target-provider-services.md).

**Topics**
+ [Creating an ID namespace target (rule-based method)](create-id-namespace-target-rule-based.md)
+ [Creating an ID namespace target (provider services method)](create-id-namespace-target-provider-services.md)

# Creating an ID namespace target (rule-based method)
<a name="create-id-namespace-target-rule-based"></a>

This topic describes the process of creating an ID namespace target using the **rule-based** method. This method uses matching rules to translate first-party data from a source to a target during an ID mapping workflow.

**To create an ID namespace target (rule-based)**

1. Sign in to the AWS Management Console and open the AWS Entity Resolution console at [https://console.aws.amazon.com/entityresolution/](https://console.aws.amazon.com/entityresolution/).

1. In the left navigation pane, under **Data preparation**, choose **ID namespaces**.

1. On the **ID namespaces** page, in the upper right corner, choose **Create ID namespace**.

1. For **Details**, do the following:

   1. For **ID namespace name**, enter a unique name.

   1. (Optional) For **Description**, enter an optional description.

   1. For **ID namespace type**, choose **Target**.

1. For the **ID namespace method**, choose **Rule-based**.

1. For **Data input**, under **Matching workflow**, do the following.

   1. Choose the account that’s associated with the ID namespace: either **Your AWS account** or **Another AWS account**.

   1. Depending to the type of account, select the **Matching workflow name** or enter the **Matching workflow ARN**.

1. For **Rule parameters**, do the following.

   1. Specify the **Rule controls** by choosing one of the following options based on your goal.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/entityresolution/latest/userguide/create-id-namespace-target-rule-based.html)

      **Rule controls** must be compatible between the source and the target to be used in an ID mapping workflow. For example, if a source ID namespace limits rules to the target but the target ID namespace limits rules to the source, this results in an error.

   1. For **Matching rules**, AWS Entity Resolution automatically adds the rules from the matching workflow. 

1. For **Comparison and matching parameters**, do the following.

   1. Specify the **Comparison type** by choosing one of the following options based on your goal.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/entityresolution/latest/userguide/create-id-namespace-target-rule-based.html)

   1. Specify the **Record matching type** by choosing one of the following options based on your goal.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/entityresolution/latest/userguide/create-id-namespace-target-rule-based.html)
**Note**  
You must specify compatible limitations for the source and target ID namespaces. For example, if a source ID namespace limits rules to the target but the target ID namespace limits rules to the source, this results in an error.

1. Specify the **Service access permissions** by choosing an **Existing service role name** from the dropdown list.

1. (Optional) To enable **Tags** for the resource, choose **Add new tag**, and then enter the **Key** and **Value** pair.

1. Choose **Create ID namespace**.

The ID namespace target is created. After you create the ID namespaces (source and target) required for an ID mapping workflow, you're ready to [create an ID mapping workflow](create-id-mapping-workflow.md).

# Creating an ID namespace target (provider services method)
<a name="create-id-namespace-target-provider-services"></a>

This topic describes the process of creating an ID namespace target using the **Provider services** method. This method uses a provider service called LiveRamp. LiveRamp translates third-party encoded data from a source to a target during an ID mapping workflow.

**To create an ID namespace target (provider services)**

1. Sign in to the AWS Management Console and open the AWS Entity Resolution console at [https://console.aws.amazon.com/entityresolution/](https://console.aws.amazon.com/entityresolution/).

1. In the left navigation pane, under **Data preparation**, choose **ID namespaces**.

1. On the **ID namespaces** page, in the upper right corner, choose **Create ID namespace**.

1. For **Details**, do the following:

   1. For **ID namespace name**, enter a unique name.

   1. (Optional) For **Description**, enter an optional description.

   1. For **ID namespace type**, choose **Target**.

1. For **ID namespace method**, choose **Provider services**.
**Note**  
AWS Entity Resolution currently offers the LiveRamp provider service as an ID namespace method.  
If you have a subscription to LiveRamp, then the status appears as **Subscribed**.  
For more information about how to subscribe to LiveRamp, see [Step 1: Subscribe to a provider service on AWS Data Exchange](prepare-third-party-input-data.md#subscribe-provider-service).

1. For **Target domain**, enter the LiveRamp client domain identifier targeted for transcoding that LiveRamp provides.

1. (Optional) To enable **Tags** for the resource, choose **Add new tag**, and then enter the **Key** and **Value** pair.

1. Choose **Create ID namespace**.

The ID namespace target is created. After you create the ID namespaces (source and target) required for an ID mapping workflow, you're ready to [Create the ID mapping workflow](create-id-mapping-workflow.md).

# Editing an ID namespace
<a name="edit-id-namespaces"></a>

You can only edit an ID namespace before you associate it to an ID mapping workflow. After you've associated an ID namespace to an ID mapping workflow, you can't edit it.

**To edit an ID namespace:**

1. Sign in to the AWS Management Console and open the AWS Entity Resolution console at [https://console.aws.amazon.com/entityresolution/](https://console.aws.amazon.com/entityresolution/).

1. In the left navigation pane, under **Data preparation**, choose **ID namespaces**.

1. Choose the ID namespace.

1. Choose **Edit**.

1. On the **Edit ID namespace** page, make any necessary changes and then choose **Save**.

# Deleting an ID namespace
<a name="delete-id-namespace"></a>

You can't delete an ID namespace when it's associated to an ID mapping workflow. You must first remove the schema mapping from all associated ID mapping workflows before you can delete it. 

**To delete an ID namespace:**

1. Sign in to the AWS Management Console and open the AWS Entity Resolution console at [https://console.aws.amazon.com/entityresolution/](https://console.aws.amazon.com/entityresolution/).

1. In the left navigation pane, under **Data preparation**, choose **ID namespaces**.

1. Choose the ID namespace.

1. Choose **Delete**.

1. Confirm the deletion and then choose **Delete**.

# Adding or updating a resource policy for an ID namespace
<a name="add-update-resource-policy-id-namespace"></a>

A resource policy allows the creator of the ID mapping resource to access your ID namespace resource.

**To add or update a resource policy**

1. Sign in to the AWS Management Console and open the AWS Entity Resolution console at [https://console.aws.amazon.com/entityresolution/](https://console.aws.amazon.com/entityresolution/).

1. In the left navigation pane, under **Workflows**, choose **ID namespaces**.

1. Choose the ID namespace.

1. On the ID namespace details page, choose the **Permissions** tab.

1. In the **Resource policy** section, choose **Edit**.

1. Add or update the policy in the JSON editor.

1. Choose **Save changes**.