カスタム SQL データセットを更新します。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
quickbi-public:UpdateCubeBySql |
update |
*All Resource
|
なし | なし |
リクエスト構文
POST HTTP/1.1
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| CubeId |
string |
必須 |
データセット ID。 |
7c7223ae-****-3c744528014b |
| CustomSql |
string |
必須 |
カスタム SQL ステートメント。 |
select * from sdsd |
| WorkspaceId |
string |
必須 |
ワークスペース ID。 |
95296e95-ca89-4c7d-8af9-dedf0ad0**** |
| UserId |
string |
必須 |
データセットを作成する権限を持つユーザーの Quick BI UserId。これは Alibaba Cloud アカウント ID ではありません。 QueryUserInfoByAccount 操作を呼び出して UserId を取得します。 |
95296e95-ca89-4c7d-8af9-dedf0ad0**** |
| DsId |
string |
必須 |
データソース ID。 |
7AAB95D-*****-****-*4FC0C976 |
| Placeholders |
string |
任意 |
プレースホルダーパラメーター。詳細については、以下の補足説明を参照してください。フォーマットの詳細も以下を参照してください。 |
[ { "name": "test", "style": "placeholder", "type": "string" } ] |
プレースホルダー PlaceholderModel 構造
-
uniqueId -- string、任意、プレースホルダーの一意の ID。プレースホルダーの作成時にこのパラメーターを指定する必要はありません。指定しても使用されません。(このフィールドは更新時に使用されます。)
-
name -- string、必須、プレースホルダー名。一意である必要があります。
-
style -- string、必須、プレースホルダーのタイプ。
式プレースホルダー: param
値プレースホルダー: placeholder
条件プレースホルダー: condition
-
type -- String、プレースホルダーの変数タイプ。
テキスト: string
数値: number
日付: 以下のフォーマットの説明を参照してください。
-
useInGlobal -- Boolean、任意、プレースホルダーがグローバルに有効かどうかを指定します。デフォルト値: false。
はい: true
いいえ: false
-
defaultValue -- List
、任意、プレースホルダーのデフォルト値。shipping_date_ph.get(0) プレースホルダータイプの場合、デフォルト値の数は 0 または 2 のみです。その他のプレースホルダータイプの場合、数は 0 または 1 のみです。 -
format -- String、任意、日付タイプのフォーマット(以下のフォーマットの説明を参照してください)。
-
originalType -- String、任意。値プレースホルダーが shipping_date_ph.get(0) 日付タイプの場合、originalType を dateRange に設定します。その他のすべてのケースでは、このパラメーターを設定する必要はありません。
-
conditionPlaceHolderFields -- List、任意、条件プレースホルダーのフィールド。条件プレースホルダーの場合のみこのパラメーターを設定します。
ConditionPlaceHolderFields 構造
uniqueId -- String、任意、条件プレースホルダーフィールドの一意の ID。プレースホルダーの作成時にこのパラメーターを指定する必要はありません。システムがデフォルトで値を生成します。
column -- String、必須、物理フィールド名。
式プレースホルダーの style と type のマッピング
変数タイプ ### 対応する type 値。
テキスト string
数値 number
日付-年 yearRegion
日付-年四半期 quarterRegion
日付-年月 monthRegion
日付-年週 weekRegion
日付-年月日 dateRegion
日付-年月日時分秒 ymdHmsRegion
値プレースホルダーの style、type、フォーマットのマッピング(空欄は不要を意味します)
変数タイプ ### 対応する type 値 ### フォーマット。
テキスト string(shipping_date_ph.get(0) 日付タイプではサポートされません)
数値 number(shipping_date_ph.get(0) 日付タイプではサポートされません)
日付-年 yearRegion
日付-年四半期 quarterRegion
日付-年月 monthRegion YYYY-MM または YYYYMM または YYYY/MM。3 つのフォーマットから 1 つを選択します。
日付-年週 weekRegion
日付-年月日 dateRegion YYYY-MM-DD または YYYYMMDD または YYYY/MM/DD。3 つのフォーマットから 1 つを選択します。
日付-年月日時分秒 ymdHmsRegion YYYY-MM-DD HH:MI:SS または YYYYMMDD HH:MI:SS または YYYY/MM/DD HH:MI:SS または YYYYMMDDHHMISS。4 つのフォーマットから 1 つを選択します。
条件プレースホルダーの style と type のマッピング
変数タイプ ### 対応する type 値。
テキスト string。
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
応答のスキーマ。 |
||
| RequestId |
string |
リクエスト ID。 |
617277******************ABA47E31 |
| Result |
boolean |
操作の実行結果。有効な値:
|
true |
| Success |
boolean |
リクエストが成功したかどうかを示します。有効な値:
|
true |
例
成功レスポンス
JSONJSON
{
"RequestId": "617277******************ABA47E31",
"Result": true,
"Success": true
}
エラーコード
|
HTTP ステータスコード |
エラーコード |
エラーメッセージ |
説明 |
|---|---|---|---|
| 400 | Internal.System.Error | An internal system error occurred. | |
| 400 | Invalid.User.Organization | The user is not in your organization. | |
| 400 | User.NotIn.Workspace | The user is not a member of the group workspace. | このユーザーはこのワークスペースに参加していません。 |
| 400 | Workspace.NotIn.Organization | The workspace is not owned by the organization. | 指定されたワークスペースは組織単位内にありません。 |
| 400 | Datasource.NotFound.Error | The specified data source does not exist: %s. | 指定されたデータソースは存在しません:%s。 |
| 400 | Invalid.Param.Error | The parameter is invalid. | 指定されたパラメーターは無効です。 |
| 400 | Cube.Not.Exist | The Cube does not exist. | |
| 400 | CubeSchema.Not.Exist | The cube schema does not exist. | |
| 400 | Cube.DuplicatedName.Error | The dataset name already exists. Modify the name before saving. | |
| 400 | Directory.NotExist.Error | The directory does not exist. | |
| 400 | Xengnie.TaskExecute.Error | Fail to execute task %s. | |
| 400 | Datasource.Sql.ExecuteFailed | Failed to execute the SQL statement in the data source. | |
| 400 | Placeholder.Date.Illegal | The placeholder date format is illegal. | |
| 400 | Placeholder.DefaultValue.Invalid | Invalid placeholder default value. | |
| 400 | Placeholder.Style.Illegal | Illegal placeholder style. | |
| 400 | Placeholder.Type.Illegal | Illegal placeholder type. | |
| 400 | Placeholder.UniqueId.Duplicate | Sql placeholder uniqueId duplicate. | |
| 400 | PlaceholderName.Duplicate.Error | Sql placeholder name duplicate. | |
| 400 | PlaceholderName.NotMatch.Error | The parsing and input placeholder names do not match. | |
| 400 | Placeholder.FieldNot.Empty | Condition placeHolder field not empty. |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。