Show Menu
トピック×

付録

The following sections provide reference information for various features of the Sensei Machine Learning API.

アセット取得用のクエリーパラメーター

The Sensei Machine Learning API provides support for query parameters with retrieving assets. 使用可能なクエリパラメーターとその使用方法を次の表に示します。
クエリーパラメーター
説明
デフォルト値
start
ページネーションの開始インデックスを示します。
start=0
limit
返す結果の最大数を示します。
limit=25
orderby
優先順での並べ替えに使用するプロパティを示します。プロパティ名の前にダッシュ( - )を含めると、降順で並べ替えられます。それ以外の場合、結果は昇順で並べ替えられます。
orderby=created
property
オブジェクトが返される式の中で満たす必要がある比較パラメーターを示します。
property=deleted==false
複数のクエリパラメーターを組み合わせる場合は、アンパサンド( & )で区切る必要があります。

Python CPU と GPU の設定

Python Engines は、トレーニングまたはスコアリングの目的で CPU または GPU のいずれかを選択でき、 MLInstance でタスク仕様( tasks.specification )として定義されます。
次の設定例では、トレーニングに CPU を使用し、スコアに GPU を使用するよう指定しています。
[
    {
        "name": "train",
        "parameters": [
            {
                "key": "training parameter",
                "value": "parameter value"
            }    
        ],
        "specification": {
            "type": "ContainerTaskSpec",
            "cpus": "1"
        }
    },
    {
        "name": "score",
        "parameters": [
            {
                "key": "scoring parameter",
                "value": "parameter value" 
            }
        ],
        "specification": {
            "type": "ContainerTaskSpec",
            "gpus": "1"
        }
    }
]

cpus gpus の値は、CPU と GPU の数ではなく、物理マシンの数を示します。これらの値は許容できる "1" であり、それ以外の場合は例外がスローされます。

PySpark および Spark のリソース設定

Spark Enginesには、トレーニングとスコアリングの目的で計算リソースを変更する機能があります。 次の表に、これらのリソースを示します。
リソース
説明
タイプ
driverMemory
ドライバのメモリ(MB)
int
driverCores
ドライバが使用するコアの数
int
executorMemory
実行者のメモリ(MB)
int
executorCores
実行者が使用するコアの数
int
numExecutors
実行者の数
int
リソースは、 MLInstance に対して、(A)個々のトレーニングまたはスコアリングパラメーター、または(B)追加の仕様オブジェクト内( specification )として指定できます。たとえば、次のリソース設定は、トレーニングとスコアの両方で同じです。
[
    {
        "name": "train",
        "parameters": [
            {
                "key": "driverMemory",
                "value": "2048"
            },
            {
                "key": "driverCores",
                "value": "1"
            },
            {
                "key": "executorMemory",
                "value": "2048"
            },
            {
                "key": "executorCores",
                "value": "2"
            },
            {
                "key": "numExecutors",
                "value": "3"
            }
        ]
    },
    {
        "name": "score",
        "parameters": [
            {
                "key": "scoring parameter",
                "value": "parameter value"
            }
        ],
        "specification": {
            "type": "SparkTaskSpec",
            "name": "Spark Task name",
            "className": "Class name",
            "driverMemoryInMB": 2048,
            "driverCores": 1,
            "executorMemoryInMB": 2048,
            "executorCores": 2,
            "numExecutors": 3
        }
    }
]