Encontrar grupos de atributos em suo Feature Store - Amazon SageMaker
Como encontrar grupos de atributos

Encontrar grupos de atributos em suo Feature Store

Com o Amazon SageMaker Feature Store, você pode pesquisar os grupos de atributos usando o console ou a operação Pesquisar. 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 atributos que você está pesquisando devem estar na sua conta Região da AWS e AWS ou serem compartilhados e estar detectáveis para sua 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.

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 atributos usando o Amazon SageMaker Studio Classic ou a operação Search na API do SageMaker. 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 Sim Sim
Hora de criação CreationTime Sim Sim
Descrição Descrição Sim Sim
Nome do atributo no horário do evento EventTimeFeatureName Não Não
Definições de atributos FeatureDefinitions Não Não
ARN do grupo de atributos FeatureGroupARN Não Não
Nome do grupo de atributos FeatureGroupName 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 atributo do identificador de registro RecordIdentifierFeatureName Sim Sim
Tags Tags.key Sim Não

Como encontrar grupos de atributos

Você pode usar a API do Amazon SageMaker Feature Store ou console para encontrar seus grupos de atributos. As instruções para usar o Feature Store por meio do console dependem de você ter ativado Amazon SageMaker Studio ou Amazon SageMaker Studio Classic como sua experiência padrão.

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

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

  3. Na lista suspensa, escolha Feature Store.

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

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

  6. 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.

  7. 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.

O código nesta seção usa a operação Search no AWS SDK for Python (Boto3) para realizar a consulta de pesquisa a fim de encontrar grupos de atributos. Para obter informações sobre as outras linguagens para enviar uma consulta, consulte Ver também na Referência da API do Amazon SageMaker.

Para obter mais exemplos e recursos do Feature Store, consulte Recursos do 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 Python de APIs AWS RAM para criar compartilhamento de recursos. A assinatura da API é fornecida abaixo. Para usar o SDK Python para APIs do AWS RAM, anexe a política gerenciada de acesso completo do AWS RAM ao perfil 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',
    ]
)