Tworzenie funkcji zdefiniowanej przez użytkownikaCreate User Defined Function

Create User Defined FunctionOperacja tworzy nową procedurę składowaną w kolekcji.The Create User Defined Function operation creates a new stored procedure in a collection.

ŻądanieRequest

MetodaMethod Identyfikator URI żądaniaRequest URI OpisDescription
POSTPOST https://{databaseaccount}.documents.azure.com/dbs/{db-id}/colls/{coll-id}/udfs {Databaseaccount} to nazwa konta Azure Cosmos DB utworzonego w ramach subskrypcji.The {databaseaccount} is the name of the Azure Cosmos DB account created under your subscription. Wartość {dB-ID} jest wygenerowaną przez użytkownika nazwą/IDENTYFIKATORem bazy danych, w której jest tworzony system UDF, a nie wygenerowanym IDENTYFIKATORem (RID) bazy danych.The {db-id} value is the user generated name/ID of the database where the UDF is created, not the system generated ID (rid) of the database. Wartość {Coll-ID} jest nazwą kolekcji, w której jest tworzony system UDF.The {coll-id} value is the name of the collection where the UDF is created.

NagłówkiHeaders

Zapoznaj się z Typowymi nagłówkami żądań REST Azure Cosmos DB dla nagłówków, które są używane przez wszystkie żądania Azure Cosmos DB.See Common Azure Cosmos DB REST request headers for headers that are used by all Azure Cosmos DB requests.

TreśćBody

WłaściwośćProperty WymaganyRequired TypType OpisDescription
idid WymaganeRequired CiągString Jest to unikatowa nazwa identyfikująca format UDF.It is a unique name to identify the UDF. Długość identyfikatora nie może przekraczać 255 znaków.The id must not exceed 255 characters.
jednostcebody WymaganeRequired CiągString Jest to treść UDF.It is the body of the UDF.
{  
    "body": "function tax(income) {\r\n    if(income == undefined) \r\n        throw 'no input';\r\n    if (income < 1000) \r\n        return income * 0.1;\r\n    else if (income < 10000) \r\n        return income * 0.2;\r\n    else\r\n        return income * 0.4;\r\n}",  
    "id": "simpleTaxUDF"  
}  
  

ReakcjaResponse

NagłówkiHeaders

Zobacz wspólne Azure Cosmos DB nagłówki odpowiedzi REST dla nagłówków, które są zwracane przez wszystkie Azure Cosmos DB odpowiedzi.See Common Azure Cosmos DB REST response headers for headers that are returned by all Azure Cosmos DB responses.

Kody stanuStatus codes

Poniższa tabela zawiera listę typowych kodów stanu zwracanych przez tę operację.The following table lists common status codes returned by this operation. Aby uzyskać pełną listę kodów stanu, zobacz kody stanu HTTP.For a full list of status codes, see HTTP Status Codes.

Kod stanu HTTPHTTP status code OpisDescription
201 Utworzono201 Created Operacja zakończyła się pomyślnie.The operation was successful.
400 Nieprawidłowe żądanie400 Bad Request Treść JSON jest nieprawidłowa.The JSON body is invalid. Wyszukaj brakujące nawiasy klamrowe lub cudzysłowy.Check for missing curly brackets or quotes.
409 Konflikt409 Conflict Identyfikator podany dla nowego elementu UDF został pobrany przez istniejące UDF.The ID provided for the new UDF has been taken by an existing UDF.

TreśćBody

WłaściwośćProperty OpisDescription
_rid_rid Jest to właściwość wygenerowana przez system.It is a system generated property. Identyfikator zasobu (_rid) jest unikatowym identyfikatorem, który jest również hierarchiczny dla stosu zasobów w modelu zasobów.The resource ID (_rid) is a unique identifier that is also hierarchical per the resource stack on the resource model. Jest używany wewnętrznie do umieszczania i nawigowania w ramach zasobu UDF.It is used internally for placement and navigation of the UDF resource.
_ts_ts Jest to właściwość wygenerowana przez system.It is a system generated property. Określa ostatnią zaktualizowaną sygnaturę czasową zasobu.It specifies the last updated timestamp of the resource. Wartość jest sygnaturą czasową.The value is a timestamp.
_self_self Jest to właściwość wygenerowana przez system.It is a system generated property. Jest to unikatowy adres URI dla zasobu.It is the unique addressable URI for the resource.
_etag_etag Jest to wygenerowane przez system właściwość, która określa element ETag zasobu wymagany do optymistycznej kontroli współbieżności.It is a system generated property that specifies the resource etag required for optimistic concurrency control.
{  
    "body": "function tax(income) {\r\n    if(income == undefined) \r\n        throw 'no input';\r\n    if (income < 1000) \r\n        return income * 0.1;\r\n    else if (income < 10000) \r\n        return income * 0.2;\r\n    else\r\n        return income * 0.4;\r\n}",  
    "id": "simpleTaxUDF",  
    "_rid": "Sl8fALN4sw4BAAAAAAAAYA==",  
    "_ts": 1449687949,  
    "_self": "dbs\/Sl8fAA==\/colls\/Sl8fALN4sw4=\/udfs\/Sl8fALN4sw4BAAAAAAAAYA==\/",  
    "_etag": "\"06003ee4-0000-0000-0000-56687b8d0000\""  
}  
  

PrzykładExample

POST https://contosomarketing.documents.azure.com/dbs/volcanodb/colls/volcano1/udfs HTTP/1.1  
x-ms-session-token: 37  
x-ms-date: Wed, 09 Dec 2015 19:05:49 GMT  
authorization: type%3dmaster%26ver%3d1.0%26sig%3d6OaA6qWdazmZ%2fp5LjSROiDEjquzF5a9YIPFRqLQEenM%3d  
Cache-Control: no-cache  
User-Agent: contoso/1.0  
x-ms-version: 2015-08-06  
Accept: application/json  
Host: contosomarketing.documents.azure.com  
Cookie: x-ms-session-token=37  
Content-Length: 287  
Expect: 100-continue  
Connection: Keep-Alive  
  
{  
    "body": "function tax(income) {\r\n    if(income == undefined) \r\n        throw 'no input';\r\n    if (income < 1000) \r\n        return income * 0.1;\r\n    else if (income < 10000) \r\n        return income * 0.2;\r\n    else\r\n        return income * 0.4;\r\n}",  
    "id": "simpleTaxUDF"  
}  
  
HTTP/1.1 201 Created  
Cache-Control: no-store, no-cache  
Pragma: no-cache  
Content-Type: application/json  
Server: Microsoft-HTTPAPI/2.0  
Strict-Transport-Security: max-age=31536000  
x-ms-last-state-change-utc: Sun, 29 Nov 2015 19:20:18.154 GMT  
etag: "06003ee4-0000-0000-0000-56687b8d0000"  
x-ms-resource-quota: functions=25;  
x-ms-resource-usage: functions=1;  
x-ms-schemaversion: 1.1  
x-ms-alt-content-path: dbs/volcanodb/colls/volcano1  
x-ms-content-path: Sl8fALN4sw4=  
x-ms-quorum-acked-lsn: 37  
x-ms-session-token: 38  
x-ms-current-write-quorum: 3  
x-ms-current-replica-set-size: 4  
x-ms-request-charge: 4.95  
x-ms-serviceversion: version=1.5.57.3  
x-ms-activity-id: 2fdee379-7044-4275-a655-5367bf0a3798  
x-ms-gatewayversion: version=1.5.57.3  
Date: Wed, 09 Dec 2015 19:05:51 GMT  
Content-Length: 468  
  
{  
    "body": "function tax(income) {\r\n    if(income == undefined) \r\n        throw 'no input';\r\n    if (income < 1000) \r\n        return income * 0.1;\r\n    else if (income < 10000) \r\n        return income * 0.2;\r\n    else\r\n        return income * 0.4;\r\n}",  
    "id": "simpleTaxUDF",  
    "_rid": "Sl8fALN4sw4BAAAAAAAAYA==",  
    "_ts": 1449687949,  
    "_self": "dbs\/Sl8fAA==\/colls\/Sl8fALN4sw4=\/udfs\/Sl8fALN4sw4BAAAAAAAAYA==\/",  
    "_etag": "\"06003ee4-0000-0000-0000-56687b8d0000\""  
}  
  

Zobacz teżSee Also