Query file metadata - Intelligent Media Management - Centre de documentation Alibaba Cloud

Une fois l'index de métadonnées créé, interrogez les métadonnées d'un ou plusieurs fichiers en appelant les opérations API d'Intelligent Media Management (IMM). Vous pouvez également rechercher des métadonnées par champ, par mot-clé flou ou par mot-clé en langage naturel. Cette rubrique explique comment interroger les métadonnées de fichier.

Prérequis

Créez un index de métadonnées pour vos fichiers en fonction de votre scénario d'utilisation. Pour plus d'informations, consultez la section Créer un index de métadonnées.

Méthodes d'interrogation

Le tableau suivant décrit les méthodes disponibles pour interroger les métadonnées de fichier.

Méthode	Description
Interroger les métadonnées d'un seul fichier	Appelez l'opération GetFileMeta pour interroger les métadonnées d'un seul fichier.
Interroger les métadonnées de plusieurs fichiers	Appelez l'opération BatchGetFileMeta pour récupérer simultanément les métadonnées de plusieurs fichiers.
Effectuer une requête simple	Appelez l'opération SimpleQuery pour rechercher les fichiers correspondant aux conditions spécifiées et lister les métadonnées par champ selon un ordre de tri défini. Utilisez également l'imbrication pour effectuer des requêtes complexes et des opérations d'agrégation afin d'analyser statistiquement les valeurs des différents champs. Pour obtenir la liste des champs et opérateurs pris en charge, consultez la section Champs et opérateurs pris en charge.
Effectuer une recherche floue	Appelez l'opération FuzzyQuery pour rechercher les fichiers correspondant à la chaîne spécifiée et lister leurs métadonnées. IMM recherche la chaîne spécifiée dans les champs de métadonnées extraits, tels que le nom de fichier, le libellé, le chemin ou le libellé personnalisé. Si la valeur d'un champ de métadonnées d'un fichier correspond à la chaîne spécifiée, toutes les métadonnées du fichier sont renvoyées.
Effectuer une recherche par mot-clé en langage naturel	Appelez l'opération SemanticQuery pour interroger les métadonnées d'un jeu de données à l'aide de mots-clés en langage naturel. L'opération prend en charge les recherches sémantiques basées sur les champs Labels, ProduceTime et AddressLine. Par exemple, pour interroger les métadonnées de fichiers liés sémantiquement à « ciel au-dessus de Hangzhou », spécifiez « Query=sky over Hangzhou » comme condition de requête.

Interroger les métadonnées d'un seul fichier

Cet exemple interroge les métadonnées du fichier oss://test-bucket/test-object.jpg à partir du jeu de données test-dataset dans le projet test-project.

Exemple de requête

{
    "ProjectName": "test-project",
    "URI": "oss://test-bucket/test-object.jpg",
    "DatasetName": "test-dataset"
}

Exemple de réponse

{
    "RequestId": "645FB6D9-5EA0-02C9-B253-****",
    "Files": [
        {
            "ProduceTime": "2020-08-19T17:11:11+08:00",
            "ObjectACL": "default",
            "ContentType": "image/jpeg",
            "ProjectName": "test-project",
            "Size": 22868,
            "URI": "oss://test-bucket/test-object.jpg",
            "Addresses": [
                {
                    "Language": "zh-Hans",
                    "Township": "Tanggou Town",
                    "AddressLine": "Chenlongzhuang, Tanggou Town, Shuyang County, Suqian City, Jiangsu Province",
                    "Country": "China",
                    "City": "Suqian",
                    "District": "Shuyang",
                    "Province": "Jiangsu"
                }
            ],
            "ObjectType": "file",
            "CustomLabels": {
                "category": "Persons"
            },
            "OwnerId": "****",
            "FileModifiedTime": "2021-05-13T10:22:44+08:00",
            "ImageWidth": 270,
            "OSSStorageClass": "Standard",
            "MediaType": "image",
            "ObjectId": "****",
            "CreateTime": "2022-07-06T07:10:18.497753661+08:00",
            "Filename": "1.jpg",
            "Labels": [
                {
                    "CentricScore": 0.921999990940094,
                    "Language": "zh-Hans",
                    "LabelConfidence": 1,
                    "LabelName": "Hairstyle",
                    "LabelLevel": 2,
                    "ParentLabelName": "Daily behavior"
                },
                ...
            ],
            "Orientation": 1,
            "Figures": [
                {
                    "Beard": "none",
                    "MaskConfidence": 0.6959999799728394,
                    "Gender": "female",
                    "Boundary": {
                        "Left": 70,
                        "Top": 75,
                        "Height": 134,
                        "Width": 101
                    },
                    ...
                }
            ],
            "EXIF": "...",
            "ContentMd5": "HZwoCnxPZ/fvhz4oRJ****",
            "ImageHeight": 270,
            "ImageScore": {
                "OverallQualityScore": 0.6140000224113464
            },
            "ETag": "\"1D9C280A7C4F67F7EF873E28449D****\"",
            "DatasetName": "test-dataset",
            "FileHash": "\"1D9C280A7C4F67F7EF873E2****\"",
            "UpdateTime": "2022-07-06T07:10:18.497753661+08:00",
            "OSSCRC64": "5634447745650079669",
            "OSSTaggingCount": 0,
            "LatLong": "34.000000,119.000000",
            "OSSObjectType": "Normal"
        }
    ]
}

Exemple de code complet (SDK IMM pour Python V1.27.3)

# -*- coding: utf-8 -*-

import os
from alibabacloud_imm20200930.client import Client as imm20200930Client
from alibabacloud_tea_openapi import models as open_api_models
from alibabacloud_imm20200930 import models as imm_20200930_models
from alibabacloud_tea_util import models as util_models
from alibabacloud_tea_util.client import Client as UtilClient

class Sample:
    def __init__(self):
        pass

    @staticmethod
    def create_client(
        access_key_id: str,
        access_key_secret: str,
    ) -> imm20200930Client:
        """
        Use your AccessKey ID and AccessKey secret to initialize the client. 
        @param access_key_id:
        @param access_key_id:
        @param access_key_secret:
        @return: Client
        @throws Exception
        """
        config = open_api_models.Config(
            access_key_id=access_key_id,
            access_key_secret=access_key_secret
        )
        # Specify the endpoint. 
        config.endpoint = f'imm.cn-beijing.aliyuncs.com'
        return imm20200930Client(config)

    @staticmethod
    def main() -> None:
        # The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. Using these credentials to perform operations is a high-risk operation. We recommend that you use a RAM user to call API operations or perform routine O&M. 
        # For security reasons, we recommend that you do not embed your AccessKey pair in your project code. 
        # In this example, the AccessKey pair is obtained from the environment variables to implement identity verification for API access. For information about how to configure environment variables, visit https://www.alibabacloud.com/help/en/imm/developer-reference/configure-environment-variables. 
        imm_access_key_id = os.getenv("AccessKeyId")
        imm_access_key_secret = os.getenv("AccessKeySecret")
        client = Sample.create_client(imm_access_key_id, imm_access_key_secret)
        get_file_meta_request = imm_20200930_models.GetFileMetaRequest(
            project_name='test-project',
            dataset_name='test-dataset',
            uri='oss://test-bucket/test-object.jpg'
        )
        runtime = util_models.RuntimeOptions()
        try:
            # Print the response of the API operation. 
            response = client.get_file_meta_with_options(get_file_meta_request, runtime)
            print(response.body.to_map())
        except Exception as error:
            # Print the error message if necessary. 
            UtilClient.assert_as_string(error.message)
            print(error)

if __name__ == '__main__':
    Sample.main()

Interroger les métadonnées de plusieurs fichiers

Cet exemple interroge les métadonnées des fichiers oss://test-bucket/test-object1.jpg et oss://test-bucket/test-object2.jpg à partir du jeu de données test-dataset dans le projet test-project.

Exemple de requête

{
    "ProjectName": "test-project",
    "DatasetName": "test-dataset",
    "URIs": "[\"oss://test-bucket/test-object.jpg\", \"oss://test-bucket/test-object2.jpg\"]"
}

Exemple de réponse (consultez l'exemple de réponse dans la section Interroger les métadonnées d'un seul fichier)

Exemple de code complet (SDK IMM pour Python V1.27.3)

# -*- coding: utf-8 -*-

import os
from alibabacloud_imm20200930.client import Client as imm20200930Client
from alibabacloud_tea_openapi import models as open_api_models
from alibabacloud_imm20200930 import models as imm_20200930_models
from alibabacloud_tea_util import models as util_models
from alibabacloud_tea_util.client import Client as UtilClient

class Sample:
    def __init__(self):
        pass

    @staticmethod
    def create_client(
        access_key_id: str,
        access_key_secret: str,
    ) -> imm20200930Client:
        """
        Use your AccessKey ID and AccessKey secret to initialize the client. 
        @param access_key_id:
        @param access_key_secret:
        @return: Client
        @throws Exception
        """
        config = open_api_models.Config(
            access_key_id=access_key_id,
            access_key_secret=access_key_secret
        )
        # Specify the endpoint. 
        config.endpoint = f'imm.cn-beijing.aliyuncs.com'
        return imm20200930Client(config)

    @staticmethod
    def main() -> None:
        # The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. Using these credentials to perform operations is a high-risk operation. We recommend that you use a RAM user to call API operations or perform routine O&M. 
        # For security reasons, we recommend that you do not embed your AccessKey pair in your project code. 
        # In this example, the AccessKey pair is obtained from the environment variables to implement identity verification for API access. For information about how to configure environment variables, visit https://www.alibabacloud.com/help/en/imm/developer-reference/configure-environment-variables. 
        imm_access_key_id = os.getenv("AccessKeyId")
        imm_access_key_secret = os.getenv("AccessKeySecret")
        client = Sample.create_client(imm_access_key_id, imm_access_key_secret)
        batch_get_file_meta_request = imm_20200930_models.BatchGetFileMetaRequest(
            project_name='test-project',
            dataset_name='test-dataset',
            uris=[
                'oss://test-bucket/test-object1.jpg',
                'oss://test-bucket/test-object2.jpg'
            ]
        )
        runtime = util_models.RuntimeOptions()
        try:
            # Print the response of the API operation. 
            response = client.batch_get_file_meta_with_options(batch_get_file_meta_request, runtime)
            print(response.body.to_map())
        except Exception as error:
            # Print the error message if necessary. 
            UtilClient.assert_as_string(error.message)
            print(error)

if __name__ == '__main__':
    Sample.main()

Effectuer une requête simple

Exemple 1

Les conditions de la requête sont les suivantes :

Nom du projet : test-project
Nom du jeu de données : test-dataset
Type de fichier : image
Tri des résultats : ordre croissant de la taille du fichier
Nombre maximal de résultats renvoyés : 100

Voici un exemple :

Exemple de requête

{
    "Query": "{\"Field\": \"ContentType\", \"Operation\": \"prefix\", \"Value\": \"image\"}",
    "ProjectName": "test-project",
    "DatasetName": "test-dataset"
    "Sort": "Size",
    "Order": "asc",
    "MaxResults": 100
}

Exemple de réponse (consultez l'exemple de réponse dans la section Interroger les métadonnées d'un seul fichier)

Exemple de code complet (SDK IMM pour Python V1.27.3)

# -*- coding: utf-8 -*-

import os
from alibabacloud_imm20200930.client import Client as imm20200930Client
from alibabacloud_tea_openapi import models as open_api_models
from alibabacloud_imm20200930 import models as imm_20200930_models
from alibabacloud_tea_util import models as util_models
from alibabacloud_tea_util.client import Client as UtilClient

class Sample:
    def __init__(self):
        pass

    @staticmethod
    def create_client(
        access_key_id: str,
        access_key_secret: str,
    ) -> imm20200930Client:
        """
        Use your AccessKey ID and AccessKey secret to initialize the client. 
        @param access_key_id:
        @param access_key_secret:
        @return: Client
        @throws Exception
        """
        config = open_api_models.Config(
            access_key_id=access_key_id,
            access_key_secret=access_key_secret
        )
        config.endpoint = f'imm.cn-beijing.aliyuncs.com'
        return imm20200930Client(config)

    @staticmethod
    def main() -> None:
        # The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. Using these credentials to perform operations is a high-risk operation. We recommend that you use a RAM user to call API operations or perform routine O&M. 
        # For security reasons, we recommend that you do not embed your AccessKey pair in your project code. 
        # In this example, the AccessKey pair is obtained from the environment variables to implement identity verification for API access. For information about how to configure environment variables, visit https://www.alibabacloud.com/help/en/imm/developer-reference/configure-environment-variables. 
        imm_access_key_id = os.getenv("AccessKeyId")
        imm_access_key_secret = os.getenv("AccessKeySecret")
        client = Sample.create_client(imm_access_key_id, imm_access_key_secret)
        request = imm_20200930_models.SimpleQueryRequest()
        params = {
            # Specify the query conditions 
            "Query": {"SubQueries": [{"Field": "ContentType", "Operation": "eq", "Value": "image/jpeg"}, {"Field": "Size", "Operation": "gt", "Value": "10485760"}, {"Field": "CustomLabels.category", "Operation": "eq", "Value": "Persons"}], "Operation": "and"},
            # Specify the name of the IMM project.
            "ProjectName": "test-project",
            # Specify the name of the dataset.
            "DatasetName": "test-dataset",
            # Specify the sorting field. 
            "Sort": "Size",
            # Specify the sorting order. 
            "Order": "asc",
            # Set the maximum number of query results to 100. 
            "MaxResults": 100
        }
        request.from_map(params)
        runtime = util_models.RuntimeOptions()
        try:
            # Print the response of the API operation. 
            response = client.simple_query_with_options(request, runtime)
            print(response.body.to_map())
        except Exception as error:
            # Print the error message if necessary. 
            UtilClient.assert_as_string(error.message)
            print(error)

if __name__ == '__main__':
    Sample.main()

Exemple 2

Les conditions de la requête sont les suivantes :

Nom du projet : test-project
Nom du jeu de données : test-dataset
Type de fichier : image
Taille du fichier : supérieure à 10 Mo
Libellés personnalisés (CustomLabels.category) : Persons
Tri des résultats : ordre croissant de la taille du fichier
Nombre maximal de résultats renvoyés : 100

Voici un exemple :

Exemple de requête

{
    "Query": "{\"SubQueries\": [{\"Field\": \"ContentType\", \"Operation\": \"prefix\", \"Value\": \"image\"}, {\"Field\": \"Size\", \"Operation\": \"gt\", \"Value\": \"10485760\"}, {\"Field\": \"CustomLabels.category\", \"Operation\": \"eq\", \"Value\": \"Persons\"}], \"Operation\": \"and\"}",
    "ProjectName": "test-project",
    "DatasetName": "test-dataset",
    "Sort": "Size",
    "Order": "asc",
    "MaxResults": 100
}

Exemple de réponse (consultez l'exemple de réponse dans la section Interroger les métadonnées d'un seul fichier)

Exemple 3

Les conditions de la requête sont les suivantes :

Nom du projet : test-project
Nom du jeu de données : test-dataset
Chemin du fichier : oss://test-bucket/
Taille du fichier : supérieure à 10 Mo
Libellés (Labels.LabelName) : « TV » ou « Stereo »
Tri des résultats : ordre croissant de la taille du fichier
Nombre maximal de résultats renvoyés : 100

Voici un exemple :

Exemple de requête

{
    "Query": "{\"SubQueries\":[{\"Field\":\"URI\",\"Value\":\"oss://test-bucket/\",\"Operation\":\"prefix\"},{\"Field\":\"Size\",\"Value\":\"10485760\",\"Operation\":\"gt\"},{\"SubQueries\":[{\"Field\":\"Labels.LabelName\",\"Value\":\"TV\",\"Operation\":\"eq\"},{\"Field\":\"Labels.LabelName\",\"Value\":\"Stereo\",\"Operation\":\"eq\"}],\"Operation\":\"or\"}],\"Operation\":\"and\"}",
    "ProjectName": "test-project",
    "DatasetName": "test-dataset",
    "Sort": "Size",
    "Order": "asc",
    "MaxResults": 100
}

Exemple de réponse (consultez l'exemple de réponse dans la section Interroger les métadonnées d'un seul fichier)

Exemple 4

Les conditions de la requête sont les suivantes :

Nom du projet : test-project
Nom du jeu de données : test-dataset
Type de fichier : image
Taille du fichier : supérieure à 10 Mo
Libellés personnalisés (CustomLabels.category) : Persons
Résultat renvoyé : taille totale des fichiers correspondants

Voici un exemple :

Exemple de requête

{
    "Query": "{\"SubQueries\": [{\"Field\": \"ContentType\", \"Operation\": \"eq\", \"Value\": \"image/jpeg\"}, {\"Field\": \"Size\", \"Operation\": \"gt\", \"Value\": \"10485760\"}, {\"Field\": \"CustomLabels.category\", \"Operation\": \"eq\", \"Value\": \"Persons\"}], \"Operation\": \"and\"}",
    "ProjectName": "test-project",
    "DatasetName": "test-dataset",
    "Aggregations": "[{\"Field\":\"Size\",\"Operation\":\"sum\"}]"
}

Exemple de réponse

{
    "RequestId": "0FB9BA35-E16B-0DFE-BD52-****",
    "Aggregations": [
        {
            "Field": "Size",
            "Value": 10485760,
            "Operation": "sum"
        }
    ]
}

Exemple 5

Les conditions de la requête sont les suivantes :

Nom du projet : test-project
Nom du jeu de données : test-dataset
Taille du fichier : supérieure à 10 Mo
Visages (Figures.Age et Figures.Gender) : âge et genre
Tri des résultats : ordre croissant de la taille du fichier
Nombre maximal de résultats renvoyés : 100

Voici un exemple :

Exemple de requête

{
    "Query": "{\"Operation\":\"not\",\"SubQueries\":[{\"Operation\":\"nested\",\"SubQueries\":[{\"Operation\":\"and\",\"SubQueries\":[{\"Field\":\"Figures.Age\",\"Operation\":\"gt\",\"Value\":\"36\"},{\"Field\":\"Figures.Gender\",\"Operation\":\"eq\",\"Value\":\"male\"},{\"Field\":\"Size\",\"Operation\":\"gt\",\"Value\":\"10485760\"}]}]}]}",
    "ProjectName": "test-project",
    "DatasetName": "test-dataset",
    "Sort": "Size",
    "Order": "asc",
    "MaxResults": 100
}

Exemple de réponse (consultez l'exemple de réponse dans la section Interroger les métadonnées d'un seul fichier)

Exemple 6

Les conditions de la requête sont les suivantes :

Nom du projet : test-project
Nom du jeu de données : test-dataset
Type de fichier : image
Taille du fichier : supérieure à 10 Mo
Libellés personnalisés (CustomLabels.category) : existence
Résultat renvoyé : taille totale des fichiers correspondants

Voici un exemple :

Exemple de requête

{
    "Query": "{\"SubQueries\": [{\"Field\": \"ContentType\", \"Operation\": \"eq\", \"Value\": \"image/jpeg\"}, {\"Field\": \"Size\", \"Operation\": \"gt\", \"Value\": \"10485760\"}, {\"Field\": \"CustomLabels.category\", \"Operation\": \"exist\"}], \"Operation\": \"and\"}",
    "ProjectName": "test-project",
    "DatasetName": "test-dataset",
    "Aggregations": "[{\"Field\":\"Size\",\"Operation\":\"sum\"}]"
}

Exemple de réponse

{
    "RequestId": "0FB9BA35-E16B-0DFE-BD52-****",
    "Aggregations": [
        {
            "Field": "Size",
            "Value": 10485760,
            "Operation": "sum"
        }
    ]
}

Effectuer une recherche floue

Cet exemple recherche les fichiers correspondant à la chaîne jpg dans le jeu de données test-dataset du projet test-project.

Exemple de requête

{
    "ProjectName": "test-project",
    "DatasetName": "test-dataset",
    "Query": "jpg"
}

Exemple de réponse (consultez l'exemple de réponse dans la section Interroger les métadonnées d'un seul fichier)

Exemple de code complet (SDK IMM pour Python V1.27.3)

# -*- coding: utf-8 -*-

import os
from alibabacloud_imm20200930.client import Client as imm20200930Client
from alibabacloud_tea_openapi import models as open_api_models
from alibabacloud_imm20200930 import models as imm_20200930_models
from alibabacloud_tea_util import models as util_models
from alibabacloud_tea_util.client import Client as UtilClient

class Sample:
    def __init__(self):
        pass

    @staticmethod
    def create_client(
        access_key_id: str,
        access_key_secret: str,
    ) -> imm20200930Client:
        """
        Use your AccessKey ID and AccessKey secret to initialize the client. 
        @param access_key_id:
        @param access_key_secret:
        @return: Client
        @throws Exception
        """
        config = open_api_models.Config(
            access_key_id=access_key_id,
            access_key_secret=access_key_secret
        )
        config.endpoint = f'imm.cn-beijing.aliyuncs.com'
        return imm20200930Client(config)

    @staticmethod
    def main() -> None:
        # The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. Using these credentials to perform operations is a high-risk operation. We recommend that you use a RAM user to call API operations or perform routine O&M. 
        # For security reasons, we recommend that you do not embed your AccessKey pair in your project code. 
        # In this example, the AccessKey pair is obtained from the environment variables to implement identity verification for API access. For information about how to configure environment variables, visit https://www.alibabacloud.com/help/en/imm/developer-reference/configure-environment-variables. 
        imm_access_key_id = os.getenv("AccessKeyId")
        imm_access_key_secret = os.getenv("AccessKeySecret")
        client = Sample.create_client(imm_access_key_id, imm_access_key_secret)
        fuzzy_query_request = imm_20200930_models.FuzzyQueryRequest(
            # Specify the name of the IMM project. 
            project_name='test-project',
            # Specify the name of the dataset. 
            dataset_name='test-dataset',
            # Specify the keyword. 
            query='jpg'
        )
        runtime = util_models.RuntimeOptions()
        try:
            # Print the response of the API operation. 
            response = client.fuzzy_query_with_options(fuzzy_query_request, runtime)
            print(response.body.to_map())
        except Exception as error:
            # Print the error message if necessary. 
            UtilClient.assert_as_string(error.message)
            print(error)

if __name__ == '__main__':
    Sample.main()

Effectuer une recherche par mot-clé en langage naturel

Cet exemple recherche les fichiers liés aux pandas à Chengdu en juillet 2020 dans le jeu de données test-dataset du projet test-project.

Exemple de requête

{
    "ProjectName": "test-project",
    "DatasetName": "test-dataset",
    "Query": "Pandas in Chengdu in July 2020"
    "MaxResults": 100
}

Exemple de réponse (consultez l'exemple de réponse dans la section Interroger les métadonnées d'un seul fichier)

Exemple de code complet (SDK IMM pour Python V1.27.3)

# -*- coding: utf-8 -*-

import os
from alibabacloud_imm20200930.client import Client as imm20200930Client
from alibabacloud_tea_openapi import models as open_api_models
from alibabacloud_imm20200930 import models as imm_20200930_models
from alibabacloud_tea_util import models as util_models
from alibabacloud_tea_util.client import Client as UtilClient

class Sample:
    def __init__(self):
        pass

    @staticmethod
    def create_client(
        access_key_id: str,
        access_key_secret: str,
    ) -> imm20200930Client:
        """
        Use your AccessKey ID and AccessKey secret to initialize the client. 
        @param access_key_id:
        @param access_key_secret:
        @return: Client
        @throws Exception
        """
        config = open_api_models.Config(
            access_key_id=access_key_id,
            access_key_secret=access_key_secret
        )
        config.endpoint = f'imm.cn-beijing.aliyuncs.com'
        return imm20200930Client(config)

    @staticmethod
    def main() -> None:
        # The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. Using these credentials to perform operations is a high-risk operation. We recommend that you use a RAM user to call API operations or perform routine O&M. 
        # For security reasons, we recommend that you do not embed your AccessKey pair in your project code. 
        # In this example, the AccessKey pair is obtained from the environment variables to implement identity verification for API access. For information about how to configure environment variables, visit https://www.alibabacloud.com/help/en/imm/developer-reference/configure-environment-variables. 
        imm_access_key_id = os.getenv("AccessKeyId")
        imm_access_key_secret = os.getenv("AccessKeySecret")
        client = Sample.create_client(imm_access_key_id, imm_access_key_secret)
        semantic_query_request = imm_20200930_models.SemanticQueryRequest(
            query='Pandas in Chengdu in July 2020',
            project_name='test-project',
            dataset_name='test-dataset',
            max_results=100
        )
        runtime = util_models.RuntimeOptions()
        try:
            # Print the response of the API operation. 
            response = client.semantic_query_with_options(semantic_query_request, runtime)
            print(response.body.to_map())
        except Exception as error:
            # Print the error message if necessary. 
            UtilClient.assert_as_string(error.message)
            print(error)

if __name__ == '__main__':
    Sample.main()