ジャンプ先

• リクエスト
• レスポンス

伴意の作成

put

/database/rdf/networks/{network_owner},{network_name}/entailments/{entailment_name}

伴意を作成します。クライアントは、このサービスを起動するには、SQL開発者ロールまたはRDF開発者ロールが必要です。

リクエスト

パス・パラメータ

• entailment_name(必須): string
  伴意の名前。

  例:

  M1OWL

• network_name(必須): string
  RDFネットワークの名前。

  例:

  NET1

• network_owner(必須): string
  RDFネットワークの所有者。

  例:

  RDFUSER

サポートされるメディア・タイプ

• application/json

リクエスト本文 - application/json ()

ルート・スキーマ: schema

タイプ: object

ソースの表示

• inf_components: array inf_components
  選択的またはコンポーネント・ベースの推論を実行するための、推論コンポーネントを示すキーワードのリスト(デフォルトは、含まれているルールベースによって定義されたすべてのコンポーネント)
• models(必須): array models
  伴意に使用するモデルのリスト
• options: string
  カンマ区切りの文字列で、デフォルトの推論の動作をオーバーライドすることにより推論プロセスを制御するためのオプション
• rulebases(必須): array rulebases
  伴意に使用するルールベースのリスト

{
    "type":"object",
    "properties":{
        "models":{
            "type":"array",
            "items":{
                "type":"string"
            },
            "description":"List of models to use for the entailment"
        },
        "rulebases":{
            "type":"array",
            "items":{
                "type":"string",
                "example":"OWLPRIME"
            },
            "description":"List of rulebases to use for the entailment"
        },
        "inf_components":{
            "type":"array",
            "items":{
                "type":"string"
            },
            "description":"List of keywords representing inference components, for performing selective or component-based inferencing (the default is all components defined by the included rulebases)"
        },
        "options":{
            "type":"string",
            "description":"A comma-delimited string of options to control the inference process by overriding the default inference behavior"
        }
    },
    "required":[
        "models",
        "rulebases"
    ]
}

ネストされたスキーマ: inf_components

タイプ: array

選択的またはコンポーネント・ベースの推論を実行するための、推論コンポーネントを示すキーワードのリスト(デフォルトは、含まれているルールベースによって定義されたすべてのコンポーネント)

ソースの表示

• 配列: 文字列

{
    "type":"array",
    "items":{
        "type":"string"
    },
    "description":"List of keywords representing inference components, for performing selective or component-based inferencing (the default is all components defined by the included rulebases)"
}

ネストされたスキーマ: models

タイプ: array

伴意に使用するモデルのリスト

ソースの表示

• 配列: 文字列

{
    "type":"array",
    "items":{
        "type":"string"
    },
    "description":"List of models to use for the entailment"
}

ネストされたスキーマ: rulebases

タイプ: array

伴意に使用するルールベースのリスト

ソースの表示

• 配列: 文字列
  例: OWLPRIME

{
    "type":"array",
    "items":{
        "type":"string",
        "example":"OWLPRIME"
    },
    "description":"List of rulebases to use for the entailment"
}

例

例の選択 これは、オントロジー・モデル(TBOX)、データ・モデル(ABOX)およびOWL2RLルールベースを使用して伴意を作成する例です。 これは、並列度16を使用し、owl:sameAsに基づいて個人に対して余分なアサーションを生成せずに、OWL2 RL伴意を作成する例です。

先頭に戻る

レスポンス

サポートされるメディア・タイプ

• application/json

201レスポンス

伴意の作成が正常に完了しました。

本文 ()

ルート・スキーマ: EntailmentDetailSingle

タイプ: object

このオブジェクトは、RDF伴意に関するメタデータを表します。

ソースの表示

• datasets: string
  伴意の作成に使用するモデルおよびルールベースの名前のカンマ区切りリスト

  例: MODEL M1, RULEBASE OWLPRIME
• index_name: string
  伴意の名前

  例: M1OWL
• index_view_name: string
  必要なトリプルを含むデータベース・ビューの名前

  例: NET1#RDFI_M1OWL
• links: array links
• model_count: string
  伴意の作成に使用するモデルの数

  例: 1
• owner: string
  伴意の所有者

  例: RDFUSER
• rulebase_count: string
  伴意の作成に使用するルールベースの数

  例: 1
• status: string
  伴意のステータス(伴意が有効な場合はVALID。伴意が無効な場合はINVALID。伴意が不完全な場合はINCOMPLETE - これはINVALIDと似ていますが再作成に必要な時間がより短くなります。伴意を作成中の場合はINPROGRESS。伴意を作成中にシステム障害が発生した場合はFAILED)

  例: VALID

{
    "type":"object",
    "description":"This object represents metadata about an RDF entailment.",
    "properties":{
        "owner":{
            "type":"string",
            "example":"RDFUSER",
            "description":"the owner of the entailment"
        },
        "index_name":{
            "type":"string",
            "example":"M1OWL",
            "description":"the name of the entailment"
        },
        "index_view_name":{
            "type":"string",
            "example":"NET1#RDFI_M1OWL",
            "description":"the name of the database view that contains the entailed triples"
        },
        "status":{
            "type":"string",
            "example":"VALID",
            "description":"the status of the entailment (VALID if the entailment is valid, INVALID if the entailment is not valid, INCOMPLETE if the entailment is incomplete - similar to INVALID but requiring less time to re-create, INPROGRESS if the entailment is being created, or FAILED if a system failure occurred during the creation of the entailment)"
        },
        "model_count":{
            "type":"string",
            "example":"1",
            "description":"the number of models used to build the entailment"
        },
        "rulebase_count":{
            "type":"string",
            "example":"1",
            "description":"the number of rulebases used to build the entailment"
        },
        "datasets":{
            "type":"string",
            "example":"MODEL M1, RULEBASE OWLPRIME",
            "description":"a comma-delimited list of the names of models and rulebases used to build the entailment"
        },
        "links":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/LinkRelation"
            }
        }
    }
}

ネストされたスキーマ: links

タイプ: array

ソースの表示

• 配列: オブジェクト LinkRelation

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/LinkRelation"
    }
}

ネストされたスキーマ: LinkRelation

タイプ: object

ソースの表示

• href(required): string
• rel(required): string

{
    "type":"object",
    "properties":{
        "rel":{
            "type":"string"
        },
        "href":{
            "type":"string"
        }
    },
    "required":[
        "rel",
        "href"
    ]
}

400 レスポンス

名前が同一かモデルとルールベースの組合せが同一の、有効な伴意がすでに存在します

404レスポンス

RDFネットワークが存在しないか、参照されているモデルまたはルールベースのいずれかが存在しません

先頭に戻る