

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Encontrar grupos de atributos em suo Feature Store
<a name="feature-store-search-feature-group-metadata"></a>

Com a Amazon SageMaker Feature Store, você pode pesquisar os grupos de recursos usando o console ou a operação de [pesquisa](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_Search.html). Você pode usar a funcionalidade de pesquisa para encontrar atributos e grupos de atributos relevantes para os modelos que você está criando. Você pode usar a funcionalidade de pesquisa para encontrar rapidamente os grupos de atributos que são relevantes para seu caso de uso.

**nota**  
Os grupos de recursos que você está pesquisando devem estar dentro da sua AWS conta Região da AWS e ser compartilhados e disponibilizados para você Conta da AWS. Para obter mais informações sobre como compartilhar o catálogo do grupo de atributos e conceder detecção, consulte [Compartilhar seu catálogo de grupos de atributos](feature-store-cross-account-discoverability-share-feature-group-catalog.md).

A tabela a seguir mostra os campos pesquisáveis e se você pode usar o console para pesquisar um campo específico.

Você pode pesquisar recursos usando o Amazon SageMaker Studio Classic ou a [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_Search.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_Search.html)operação na SageMaker API. A tabela a seguir lista todos os metadados pesquisáveis e se você pode pesquisá-los no Studio. As tags podem ser pesquisadas por seus próprios grupos de atributos, mas não por grupos de atributos tornados detectáveis para você.


****  

| Metadados pesquisáveis | Nome de campo da API | Pesquisável no console? | Pesquisável com contas cruzadas? | 
| --- | --- | --- | --- | 
| Todas as tags | AllTags | Sim | Não | 
| Motivos de falha da criação | FailureReason | Não | Não | 
| Status da criação | [FeatureGroupStatus](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_FeatureGroup.html) | Sim | Sim | 
| Hora de criação | CreationTime | Sim | Sim | 
| Description | Description | Sim | Sim | 
| Nome do atributo no horário do evento | EventTimeFeatureName | Não | Não | 
| Definições de atributos | [FeatureDefinitions](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_FeatureDefinition.html) | Não | Não | 
| ARN do grupo de atributos | [FeatureGroupARN](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_FeatureGroup.html) | Não | Não | 
| Nome do grupo de atributos | [FeatureGroupName](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_FeatureGroup.html) | Sim | Sim | 
| Configuração do armazenamento offline | [OfflineStoreConfig](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_OfflineStoreConfig.html) | Não | Não | 
| Status do armazenamento offline | [OfflineStoreStatus](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_OfflineStoreStatus.html) | Sim | Sim | 
| Status da última atualização | [LastUpdateStatus](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_LastUpdateStatus.html) | Não | Não | 
| Nome do atributo do identificador de registro | RecordIdentifierFeatureName | Sim | Sim | 
| Tags | Tags.key | Sim | Não | 

## Como encontrar grupos de atributos
<a name="feature-store-search-feature-group-metadata-how-to"></a>

Você pode usar o console ou a API da Amazon SageMaker Feature Store para encontrar seus grupos de recursos. As instruções para usar o Feature Store por meio do console dependem de você ter ativado [SageMaker Estúdio Amazon](studio-updated.md) ou [Amazon SageMaker Studio Clássico](studio.md) como sua experiência padrão.

### Encontre grupos de atributos se o Studio for sua experiência padrão (console)
<a name="feature-store-search-feature-group-metadata-how-to-using-studio-updated"></a>

1. Abra o console do Studio seguindo as instruções em [Inicie o Amazon SageMaker Studio](studio-updated-launch.md).

1. Escolha **Dados** no painel de navegação à esquerda para expandir a lista suspensa.

1. Na lista suspensa, escolha Feature Store****.

1. (Opcional) Para visualizar seus grupos de atributos, escolha **Minha conta**. Para ver grupos de atributos compartilhados, escolha **Conta cruzada**.

1. Na aba **Catálogo do Feature Group**, escolha **Minha conta** para visualizar seus grupos de atributos.

1. Na aba **Catálogo do Feature Group**, escolha **Conta cruzada** para visualizar os grupos de atributos que se tornaram detectáveis para você. Em **Criado por**, você pode ver o ID da conta do proprietário do recurso.

1. Você pode pesquisar seus grupos de atributos na lista suspensa **Pesquisar**.
   + (Opcional) Para filtrar sua pesquisa, escolha o ícone de filtro ao lado da lista suspensa **Pesquisar**. Você pode usar filtros para especificar parâmetros ou intervalos de datas nos resultados da pesquisa. Se você estiver procurando um parâmetro, especifique a chave e o valor dele. Para encontrar seus grupos de atributos, você pode especificar intervalos de tempo, desmarcar colunas que não deseja consultar, escolher quais armazenamentos pesquisar ou pesquisar por status.
   + Para atributos compartilhados, você só pode editar metadados de grupos de atributos ou definições de atributos se tiver a permissão de acesso adequada concedida pela conta do proprietário do atributo. Ter a permissão de detecção por si só não permitirá que você edite metadados ou definições de atributos. Para obter informações sobre como conceder essas permissões de acesso, consulte [Habilitar o acesso entre contas](feature-store-cross-account-access.md).

### Encontrar grupos de atributos usando o SDK para Python (Boto3)
<a name="feature-store-search-feature-group-metadata-how-to-with-sdk"></a>

O código nesta seção usa a [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_Search.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_Search.html)operação no AWS SDK para Python (Boto3) para executar a consulta de pesquisa para encontrar grupos de recursos. Para obter informações sobre os outros idiomas para enviar uma consulta, consulte [Consulte também](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_Search.html#API_Search_SeeAlso) na *Amazon SageMaker API Reference*.

Para obter mais exemplos e recursos do Feature Store, consulte [Recursos da Amazon SageMaker Feature Store](feature-store-resources.md).

O código a seguir mostra diferentes exemplos de consultas de pesquisa usando a API:

```
# Return all feature groups
sagemaker_client.search(
    Resource="FeatureGroups",
)  

# Search for feature groups that are shared with your account
sagemaker_session.search(
    resource="FeatureGroup",
    search_expression={
        "Filters": [
            {
                "Name": "FeatureGroupName",
                "Value": "MyFeatureGroup",
                "Operator": "Contains",
            }
        ],
        "Operator": "And",
    },
    sort_by="Name",
    sort_order="Ascending",
    next_token="token",
    max_results=50,
    CrossAccountFilterOption="SameAccount"
)

# Search for all feature groups with a name that contains the "ver" substring
sagemaker_client.search(
    Resource="FeatureGroups",
    SearchExpression={
        'Filters': [
            {
                'Name': 'FeatureGroupName',
                'Operator': 'Contains',
                'Value': 'ver'
            },
        ]
    }
)

# Search for all feature groups that have the EXACT name "airport"
sagemaker_client.search(
    Resource="FeatureGroups",
    SearchExpression={
        'Filters': [
            {
                'Name': 'FeatureGroupName',
                'Operator': 'Equals',
                'Value': 'airport'
            },
        ]
    }
)

# Search for all feature groups that contains the name "ver"
# AND have a record identifier feature name that contains "wha"
# AND have a tag (key or value) that contains "hea"
sagemaker_client.search(
    Resource="FeatureGroups",
    SearchExpression={
        'Filters': [
            {
                'Name': 'FeatureGroupName',
                'Operator': 'Contains',
                'Value': 'ver'
            },
            {
                'Name': 'RecordIdentifierFeatureName',
                'Operator': 'Contains',
                'Value': 'wha'
            },
            {
                'Name': 'AllTags', 
                'Operator': 'Contains',
                'Value': 'hea'
            },
        ]
    }
)  

# Search for all feature groups with substring "ver" in its name
# OR feature groups that have a record identifier feature name that contains "wha"
# OR feature groups that have a tag (key or value) that contains "hea"
sagemaker_client.search(
    Resource="FeatureGroups",
    SearchExpression={
        'Filters': [
            {
                'Name': 'FeatureGroupName',
                'Operator': 'Contains',
                'Value': 'ver'
            },
            {
                'Name': 'RecordIdentifierFeatureName',
                'Operator': 'Contains',
                'Value': 'wha'
            },
            {
                'Name': 'AllTags', 
                'Operator': 'Contains',
                'Value': 'hea'
            },
        ],
        'Operator': 'Or' # note that this is explicitly set to "Or"- the default is "And"
    }
)              


# Search for all feature groups with substring "ver" in its name
# OR feature groups that have a record identifier feature name that contains "wha"
# OR tags with the value 'Sage' for the 'org' key
sagemaker_client.search(
    Resource="FeatureGroups",
    SearchExpression={
        'Filters': [
            {
                'Name': 'FeatureGroupName',
                'Operator': 'Contains',
                'Value': 'ver'
            },
            {
                'Name': 'RecordIdentifierFeatureName',
                'Operator': 'Contains',
                'Value': 'wha'
            },
            {
                'Name': 'Tags.org', 
                'Operator': 'Contains',
                'Value': 'Sage'
            },
        ],
        'Operator': 'Or' # note that this is explicitly set to "Or"- the default is "And"
    }
)

# Search for all offline only feature groups
sagemaker_client.search(
    Resource="FeatureGroups",
    SearchExpression={
        'Filters': [
            {
                'Name': 'OnlineStoreConfig.EnableOnlineStore',
                'Operator': 'NotEquals',
                'Value': 'true'
            },
            {
                'Name': 'OfflineStoreConfig.S3StorageConfig.S3Uri',
                'Operator': 'Exists'
            }
        ]
    }
)

# Search for all online only feature groups
sagemaker_client.search(
    Resource="FeatureGroups",
    SearchExpression={
        'Filters': [
            {
                'Name': 'OnlineStoreConfig.EnableOnlineStore',
                'Operator': 'Equals',
                'Value': 'true'
            },
            {
                'Name': 'OfflineStoreConfig.S3StorageConfig.S3Uri',
                'Operator': 'NotExists'
            }
        ]
    }
)

# Search for all feature groups that are BOTH online and offline
sagemaker_client.search(
    Resource="FeatureGroups",
    SearchExpression={
        'Filters': [
            {
                'Name': 'OnlineStoreConfig.EnableOnlineStore',
                'Operator': 'Equals',
                'Value': 'true'
            },
            {
                'Name': 'OfflineStoreConfig.S3StorageConfig.S3Uri',
                'Operator': 'Exists'
            }
        ]
    }
)
```

Você também pode usar o SDK de AWS RAM APIs do Python para criar compartilhamento de recursos. A assinatura da API é fornecida abaixo. Para usar o SDK da AWS RAM API python, você precisa anexar uma política gerenciada de acesso AWS RAM total à função de execução.

```
response = client.create_resource_share(
    name='string',
    resourceArns=[
        'string',
    ],
    principals=[
        'string',
    ],
    tags=[
        {
            'key': 'string',
            'value': 'string'
        },
    ],
    allowExternalPrincipals=True|False,
    clientToken='string',
    permissionArns=[
        'string',
    ]
)
```