Encontrar grupos de recursos no seu Feature Store

Com a Amazon SageMaker Feature Store, você pode pesquisar os grupos de recursos usando o console ou a operação de pesquisa. Você pode usar a funcionalidade de pesquisa para encontrar recursos e grupos de recursos relevantes para os modelos que você está criando. Você pode usar a funcionalidade de pesquisa para encontrar rapidamente os grupos de recursos 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 recursos e conceder visibilidade, consulteCompartilhar seu catálogo de grupos de atributos.

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 Searchoperação na SageMaker API. A tabela a seguir lista todos os metadados pesquisáveis e se você pode pesquisá-los no console. As tags podem ser pesquisadas por seus próprios grupos de recursos, mas não por grupos de recursos 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	Sim	Sim
Hora de criação	CreationTime	Sim	Sim
Descrição	Descrição	Sim	Sim
Nome do recurso de horário do evento	EventTimeFeatureName	Não	Não
Definições de recursos	FeatureDefinitions	Não	Não
ARN do grupo de recursos	FeatureGroupARN	Não	Não
Nome do grupo de recursos	FeatureGroupNome	Sim	Sim
Configuração do armazenamento offline	OfflineStoreConfig	Não	Não
Status do armazenamento offline	OfflineStoreStatus	Sim	Sim
Status da última atualização	LastUpdateStatus	Não	Não
Nome do recurso do identificador de registro	RecordIdentifierFeatureName	Sim	Sim
Tags	Tags.key	Sim	Não

Como encontrar grupos de recursos

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

Encontre grupos de recursos se o Studio for sua experiência padrão (console)

1. Abra o console do Studio seguindo as instruções emInicie o Amazon SageMaker Studio.

2. Escolha Dados no painel de navegação esquerdo para expandir a lista suspensa.

3. Na lista suspensa, escolha Feature Store.

4. (Opcional) Para visualizar seus grupos de recursos, escolha Minha conta. Para ver grupos de recursos compartilhados, escolha Conta cruzada.

5. Na guia Catálogo de grupos de recursos, escolha Minha conta para visualizar seus grupos de recursos.

6. Na guia Catálogo de grupos de recursos, escolha Conta cruzada para visualizar grupos de recursos que outras pessoas tornaram visíveis para você. Em Criado por, você pode ver o ID da conta do proprietário do recurso.

7. Você pode pesquisar seus grupos de recursos 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ê pesquisar um parâmetro, especifique a chave e o valor. Para encontrar seus grupos de recursos, você pode especificar intervalos de tempo, limpar (desmarcar) as colunas que não deseja consultar, escolher lojas para pesquisar ou pesquisar por status.

   • Para recursos compartilhados, você só pode editar metadados de grupos de recursos ou definições de recursos se tiver a permissão de acesso adequada concedida pela conta do proprietário do recurso. A permissão de descoberta por si só não permitirá que você edite metadados ou definições de recursos. Para obter mais informações sobre a concessão de permissões de acesso, consulteHabilitar o acesso entre contas.

Encontre grupos de recursos usando o SDK for Python (Boto3)

O código nesta seção usa a Searchoperação no AWS SDK for 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 na Amazon SageMaker API Reference.

Para obter mais exemplos e recursos da Feature Store, consulteRecursos da Amazon SageMaker Feature Store.

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',
    ]
)