Ricerca di gruppi di funzionalità nel Feature Store - Amazon SageMaker AI
Come trovare i gruppi di funzionalità

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Ricerca di gruppi di funzionalità nel Feature Store

Con Amazon SageMaker Feature Store, puoi cercare i gruppi di funzionalità utilizzando la console o l'operazione di ricerca. Puoi utilizzare la funzionalità di ricerca per trovare funzionalità e gruppi di funzionalità pertinenti ai modelli in fase di creazione. Puoi utilizzare la funzionalità di ricerca per trovare rapidamente i gruppi di funzionalità pertinenti al tuo caso d'uso.

Nota

I gruppi di funzionalità che stai cercando devono trovarsi all'interno del tuo Regione AWS AWS account oppure essere condivisi e resi visibili al tuo Account AWS. Per ulteriori informazioni su come condividere il catalogo dei gruppi di funzionalità e garantire la rilevabilità, consulta Condividi il catalogo del tuo gruppo di funzionalità.

La tabella seguente mostra i campi ricercabili e indica se puoi utilizzare la console per cercare un campo specifico.

Puoi cercare le funzionalità utilizzando Amazon SageMaker Studio Classic o l'Searchoperazione nell' SageMaker API. La tabella seguente elenca tutti i metadati ricercabili e indica se puoi cercarli nella console. I tag possono essere ricercati per i tuoi gruppi di funzionalità, ma non per i gruppi di funzionalità resi individuabili dall'utente.

Metadati individuabili Nome del campo API Ricercabile nella console? Individuabili con account incrociato?
Tutti i tag AllTags Sì No
Motivo dell'errore di creazione FailureReason No No
Stato di creazione FeatureGroupStatus Sì Sì
Ora di creazione CreationTime Sì Sì
Description Description Sì Sì
Nome della funzionalità dell’ora dell’evento EventTimeFeatureName No No
Definizioni delle funzionalità FeatureDefinitions No No
Nome del gruppo di funzionalità FeatureGroupARN No No
Nome del gruppo di funzionalità FeatureGroupName Sì Sì
Configurazione dell'archivio offline OfflineStoreConfig No No
Stato dell'archivio offline OfflineStoreStatus Sì Sì
Stato dell’ultimo aggiornamento LastUpdateStatus No No
Nome della funzione di identificazione del record RecordIdentifierFeatureName Sì Sì
Tag Tags.key Sì No

Come trovare i gruppi di funzionalità

Puoi utilizzare la console o l'API Amazon SageMaker Feature Store per trovare i tuoi gruppi di funzionalità. Le istruzioni sull’utilizzo dell’archivio delle caratteristiche dalla console variano a seconda che l’esperienza predefinita sia impostata su Amazon SageMaker Studio o Amazon SageMaker Studio Classic.

  1. Apri la console Studio seguendo le istruzioni riportate in Avvia Amazon SageMaker Studio.

  2. Scegli Dati nel riquadro di navigazione a sinistra per espandere l’elenco a discesa.

  3. Dall'elenco a discesa, scegli Feature Store.

  4. (Facoltativo) Per visualizzare i tuoi gruppi di funzionalità, scegli Il mio account. Per visualizzare i gruppi di funzionalità condivisi, scegli Multi-account.

  5. Nella scheda Catalogo del gruppo di funzionalità, scegli Il mio account per visualizzare i tuoi gruppi di funzionalità.

  6. Nella scheda Catalogo del gruppo di funzionalità, scegli Multi-account per visualizzare i gruppi di funzionalità resi rilevabili da altri. In Creato da, puoi visualizzare l’ID dell’account proprietario di risorse.

  7. Puoi cercare i gruppi di funzionalità dall’elenco a discesa Cerca.

    • (Facoltativo) Per filtrare la ricerca, scegli l’icona del filtro accanto all’elenco a discesa Cerca. Puoi utilizzare i filtri per specificare parametri o intervalli di date nei risultati della ricerca. Se stai cercando un parametro, specificane sia la chiave sia il valore. Per trovare i gruppi di funzionalità, puoi specificare degli intervalli di tempo, rimuovere (deselezionare) le colonne da escludere dalle query, scegliere in quali archivi cercare o filtrare per stato.

    • Per le risorse condivise, è possibile modificare i metadati dei gruppi di funzionalità o le definizioni delle funzionalità solo se si dispone dell’autorizzazione di accesso appropriata concessa dall’account proprietario di risorse. La sola autorizzazione di rilevabilità non consentirà di modificare i metadati o le definizioni delle funzionalità. Per ulteriori informazioni sulla concessione delle autorizzazioni di accesso, consulta Abilitazione dell'accesso multi-account.

Il codice in questa sezione utilizza l'Searchoperazione in AWS SDK per Python (Boto3) per eseguire la query di ricerca per trovare i gruppi di funzionalità. Per informazioni sulle altre lingue in cui inviare una richiesta, consulta la sezione Vedi anche nell'Amazon SageMaker API Reference.

Per ulteriori esempi e risorse sull’archivio delle caratteristiche, consulta Risorse SageMaker di Amazon Feature Store.

Il codice seguente mostra diversi esempi di query di ricerca che utilizzano l’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'
            }
        ]
    }
)

Puoi anche usare python SDK di AWS RAM APIs per creare una condivisione di risorse. La firma API è riportata di seguito. Per utilizzare Python SDK of AWS RAM API, è necessario allegare una policy gestita ad accesso AWS RAM completo con il ruolo di esecuzione.

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