Oracle Analytics CloudのためのREST API

データセットのデータのリロード

post

/api/20210901/catalog/datasets/{datasetId}/actions/reload

指定されたIDの既存のデータセットのデータをリロードします。データセットは接続に基づいている必要があり、少なくとも1つの表のデータ・アクセス・モードを「自動キャッシュ」に設定する必要があります。データセットのリロードAPIを使用してファイルベース・データセット(Excel、CSV、TXT)をリロードすることはできません。ファイルを手動でリロードする必要があります。進行状況をモニターできるように、oa-work-request-idを返します。

リクエスト

パス・パラメータ

datasetId(必須): string(byte)

Base64URLエンコーディングを持つデータセットのオブジェクトID。たとえば、データセットにオブジェクトID'Admin'dataSet124'がある場合、Base64URLでエンコードされた値J0FkbWluJy4nZGF0YVNldDEyNCcを入力します。

この操作にはリクエスト本文はありません。

先頭に戻る

レスポンス

202レスポンス

非同期操作が開始されました。

ヘッダー

oa-work-request-id:

400レスポンス

不正なリクエスト(無効な問合せパラメータ、不正なヘッダーなど)。

ルート・スキーマ: Error

Type: object

ソースを表示

code(必須): string

プログラムによる解析を目的とした、エラーを定義する短いエラー・コード。
message(必須): string

判読可能なエラー文字列。

{
    "type":"object",
    "properties":{
        "code":{
            "type":"string",
            "description":"Short error code that defines the error, meant for programmatic parsing.\n"
        },
        "message":{
            "type":"string",
            "description":"Human-readable error string.\n"
        }
    },
    "required":[
        "code",
        "message"
    ]
}

403レスポンス

禁止(操作の権限がない、不明な理由によりリクエストが拒否されたなど)。

ルート・スキーマ: Error

Type: object

ソースを表示

code(必須): string

プログラムによる解析を目的とした、エラーを定義する短いエラー・コード。
message(必須): string

判読可能なエラー文字列。

{
    "type":"object",
    "properties":{
        "code":{
            "type":"string",
            "description":"Short error code that defines the error, meant for programmatic parsing.\n"
        },
        "message":{
            "type":"string",
            "description":"Human-readable error string.\n"
        }
    },
    "required":[
        "code",
        "message"
    ]
}

404レスポンス

見つかりません。リクエストされたリソースが見つかりませんでした。

ルート・スキーマ: Error

Type: object

ソースを表示

code(必須): string

プログラムによる解析を目的とした、エラーを定義する短いエラー・コード。
message(必須): string

判読可能なエラー文字列。

{
    "type":"object",
    "properties":{
        "code":{
            "type":"string",
            "description":"Short error code that defines the error, meant for programmatic parsing.\n"
        },
        "message":{
            "type":"string",
            "description":"Human-readable error string.\n"
        }
    },
    "required":[
        "code",
        "message"
    ]
}

409レスポンス

競合(操作によって制約違反が発生し、操作が現在の状態と互換性がないなど)。

ルート・スキーマ: Error

Type: object

ソースを表示

code(必須): string

プログラムによる解析を目的とした、エラーを定義する短いエラー・コード。
message(必須): string

判読可能なエラー文字列。

{
    "type":"object",
    "properties":{
        "code":{
            "type":"string",
            "description":"Short error code that defines the error, meant for programmatic parsing.\n"
        },
        "message":{
            "type":"string",
            "description":"Human-readable error string.\n"
        }
    },
    "required":[
        "code",
        "message"
    ]
}

500レスポンス

内部サーバー・エラー。サーバーで、リクエストの履行を妨げる予期しない状況が発生しました。

ルート・スキーマ: Error

Type: object

ソースを表示

code(必須): string

プログラムによる解析を目的とした、エラーを定義する短いエラー・コード。
message(必須): string

判読可能なエラー文字列。

{
    "type":"object",
    "properties":{
        "code":{
            "type":"string",
            "description":"Short error code that defines the error, meant for programmatic parsing.\n"
        },
        "message":{
            "type":"string",
            "description":"Human-readable error string.\n"
        }
    },
    "required":[
        "code",
        "message"
    ]
}

先頭に戻る

例

この例では、オブジェクトIDが'User1'.'Dataset1'のデータセットのデータをリロードします。最初に、Base64URLはオブジェクトID 'User1'.'Dataset1'をエンコードしてから、エンコードされた値J1VzZXIxJy4nRGF0YXNldDEnを使用してdatasetIdを指定します。

cURLの例

curl -i \
  --header 'Authorization: Bearer <token>' \
  --request POST 'https://<hostname>/api/20210901/catalog/datasets/J1VzZXIxJy4nRGF0YXNldDEn/actions/reload'

リクエスト本文の例

Not applicable.

レスポンス・ステータスの例

レスポンス・ヘッダーの例

レスポンス・ヘッダーのoa-work-request-idをメモします。この値を使用して、操作のステータスを追跡できます。

oa-work-request-id: bidr-1E309E468A4518E149438E31294EB54

レスポンス本文の例

Not applicable.

先頭に戻る