{"Entry":{"collection":"func","key":"array-sample","name":"array_sample","aliases":[],"metadata":{"changed_in":[],"changes":[{"descriptions_changed":false,"doc_overhaul":false,"from":"15","group_changed":null,"signatures":{"added":[],"removed":[]},"status":"added","to":"16"}],"content_hash":"c8a448d26844c24c4b4632c1795070f9f249bc00efb15d0060b1255e8c0ba752","first_version":"16","group":"array","group_label":"Array Functions And Operators","groups":["array"],"imported_at":"2026-09-14T21:49:48.835721+08:00","last_version":"20","name":"array_sample","name_key":"array_sample","position":19013,"present_in":["16","17","18","19","20"],"signature":"array_sample ( array anyarray, n integer ) → anyarray","signature_count":1,"slug":"array-sample","source_rev":"2026-09-14T13:14:25.684213+00:00@99e6866c","summary":"Returns an array of n items randomly selected from array.","summary_zh":""}},"Definition":{"Collection":"func","Key":"array-sample","SourceDatabase":"center","Version":"18","SourceTable":"func","SourceKey":"array-sample","SourceRevision":"2026-09-14T13:14:25.684213+00:00@99e6866c","Facts":{"description":"Returns an array of n items randomly selected from array. n may not exceed the length of array's first dimension. If array is multi-dimensional, an “item” is a slice having a given first subscript.","description_html":"Returns an array of \u003cem class=\"parameter\"\u003e\u003ccode\u003en\u003c/code\u003e\u003c/em\u003e items randomly selected from \u003cem class=\"parameter\"\u003e\u003ccode\u003earray\u003c/code\u003e\u003c/em\u003e. \u003cem class=\"parameter\"\u003e\u003ccode\u003en\u003c/code\u003e\u003c/em\u003e may not exceed the length of \u003cem class=\"parameter\"\u003e\u003ccode\u003earray\u003c/code\u003e\u003c/em\u003e's first dimension. If \u003cem class=\"parameter\"\u003e\u003ccode\u003earray\u003c/code\u003e\u003c/em\u003e is multi-dimensional, an \u003cspan class=\"quote\"\u003e“\u003cspan class=\"quote\"\u003eitem\u003c/span\u003e”\u003c/span\u003e is a slice having a given first subscript.","description_zh":"","description_zh_html":"","doc":{"anchor":"ARRAY-FUNCTIONS-TABLE","file":"functions-array.html","slug":"18"},"group":"array","group_label":"Array Functions And Operators","lang":"en","layout":"table-new","pages":["functions-array.html"],"prose_only":false,"signatures":[{"description":"Returns an array of n items randomly selected from array. n may not exceed the length of array's first dimension. If array is multi-dimensional, an “item” is a slice having a given first subscript.","description_html":"Returns an array of \u003cem class=\"parameter\"\u003e\u003ccode\u003en\u003c/code\u003e\u003c/em\u003e items randomly selected from \u003cem class=\"parameter\"\u003e\u003ccode\u003earray\u003c/code\u003e\u003c/em\u003e. \u003cem class=\"parameter\"\u003e\u003ccode\u003en\u003c/code\u003e\u003c/em\u003e may not exceed the length of \u003cem class=\"parameter\"\u003e\u003ccode\u003earray\u003c/code\u003e\u003c/em\u003e's first dimension. If \u003cem class=\"parameter\"\u003e\u003ccode\u003earray\u003c/code\u003e\u003c/em\u003e is multi-dimensional, an \u003cspan class=\"quote\"\u003e“\u003cspan class=\"quote\"\u003eitem\u003c/span\u003e”\u003c/span\u003e is a slice having a given first subscript.","description_zh":"","description_zh_html":"","examples":[{"expr":"array_sample(ARRAY[1,2,3,4,5,6], 3)","result":"{2,6,1}"},{"expr":"array_sample(ARRAY[[1,2],[3,4],[5,6]], 2)","result":"{{5,6},{1,2}}"}],"html":"\u003ccode class=\"function\"\u003earray_sample\u003c/code\u003e ( \u003cem class=\"parameter\"\u003e\u003ccode\u003earray\u003c/code\u003e\u003c/em\u003e \u003ccode class=\"type\"\u003eanyarray\u003c/code\u003e, \u003cem class=\"parameter\"\u003e\u003ccode\u003en\u003c/code\u003e\u003c/em\u003e \u003ccode class=\"type\"\u003einteger\u003c/code\u003e ) → \u003ccode class=\"returnvalue\"\u003eanyarray\u003c/code\u003e","returns":"anyarray","text":"array_sample ( array anyarray, n integer ) → anyarray","zh_from":""}],"zh_from":""},"ManualEvidence":{"doc":{"anchor":"ARRAY-FUNCTIONS-TABLE","file":"functions-array.html","slug":"18"}},"MeasuredEvidence":{}},"Text":{"Collection":"func","Key":"array-sample","SourceDatabase":"pgweb","Version":"18","Locale":"zh-Hans","Title":"array_sample","Summary":"从array中随机选取n个项并返回一个数组。n不能超过array第一维的长度。如果array是多维数组，则一个“项”是具有给定第一维下标的一个切片。","BodyHTML":"从\u003cem\u003e\u003ccode\u003earray\u003c/code\u003e\u003c/em\u003e中随机选取\u003cem\u003e\u003ccode\u003en\u003c/code\u003e\u003c/em\u003e个项并返回一个数组。\u003cem\u003e\u003ccode\u003en\u003c/code\u003e\u003c/em\u003e不能超过\u003cem\u003e\u003ccode\u003earray\u003c/code\u003e\u003c/em\u003e第一维的长度。如果\u003cem\u003e\u003ccode\u003earray\u003c/code\u003e\u003c/em\u003e是多维数组，则一个\u003cspan\u003e“\u003cspan\u003e项\u003c/span\u003e”\u003c/span\u003e是具有给定第一维下标的一个切片。\u003cpre\u003earray_sample ( array anyarray, n integer ) → anyarray\u003c/pre\u003e从\u003cem\u003e\u003ccode\u003earray\u003c/code\u003e\u003c/em\u003e中随机选取\u003cem\u003e\u003ccode\u003en\u003c/code\u003e\u003c/em\u003e个项并返回一个数组。\u003cem\u003e\u003ccode\u003en\u003c/code\u003e\u003c/em\u003e不能超过\u003cem\u003e\u003ccode\u003earray\u003c/code\u003e\u003c/em\u003e第一维的长度。如果\u003cem\u003e\u003ccode\u003earray\u003c/code\u003e\u003c/em\u003e是多维数组，则一个\u003cspan\u003e“\u003cspan\u003e项\u003c/span\u003e”\u003c/span\u003e是具有给定第一维下标的一个切片。","SourceRevision":"2026-09-12T08:18:26.491985+00:00@e2a86b52","ContentHash":"7fad62c3fa2c1bfeaa45aa61a68b913edd7ffb62821aaeaa79bde7fc5c72dc92","Payload":{"description_zh":"从array中随机选取n个项并返回一个数组。n不能超过array第一维的长度。如果array是多维数组，则一个“项”是具有给定第一维下标的一个切片。","description_zh_html":"从\u003cem class=\"parameter\"\u003e\u003ccode\u003earray\u003c/code\u003e\u003c/em\u003e中随机选取\u003cem class=\"parameter\"\u003e\u003ccode\u003en\u003c/code\u003e\u003c/em\u003e个项并返回一个数组。\u003cem class=\"parameter\"\u003e\u003ccode\u003en\u003c/code\u003e\u003c/em\u003e不能超过\u003cem class=\"parameter\"\u003e\u003ccode\u003earray\u003c/code\u003e\u003c/em\u003e第一维的长度。如果\u003cem class=\"parameter\"\u003e\u003ccode\u003earray\u003c/code\u003e\u003c/em\u003e是多维数组，则一个\u003cspan class=\"quote\"\u003e“\u003cspan class=\"quote\"\u003e项\u003c/span\u003e”\u003c/span\u003e是具有给定第一维下标的一个切片。","signatures":[{"description_zh":"从array中随机选取n个项并返回一个数组。n不能超过array第一维的长度。如果array是多维数组，则一个“项”是具有给定第一维下标的一个切片。","description_zh_html":"从\u003cem class=\"parameter\"\u003e\u003ccode\u003earray\u003c/code\u003e\u003c/em\u003e中随机选取\u003cem class=\"parameter\"\u003e\u003ccode\u003en\u003c/code\u003e\u003c/em\u003e个项并返回一个数组。\u003cem class=\"parameter\"\u003e\u003ccode\u003en\u003c/code\u003e\u003c/em\u003e不能超过\u003cem class=\"parameter\"\u003e\u003ccode\u003earray\u003c/code\u003e\u003c/em\u003e第一维的长度。如果\u003cem class=\"parameter\"\u003e\u003ccode\u003earray\u003c/code\u003e\u003c/em\u003e是多维数组，则一个\u003cspan class=\"quote\"\u003e“\u003cspan class=\"quote\"\u003e项\u003c/span\u003e”\u003c/span\u003e是具有给定第一维下标的一个切片。","returns":"anyarray","text":"array_sample ( array anyarray, n integer ) → anyarray","zh_from":"doc"}],"zh_from":"doc"}},"RequestedLocale":"zh-Hans","Fallback":false,"Versions":["16","17","18","19","20"],"Locales":["en","zh-Hans"],"Signatures":[{"Version":"18","Ordinal":0,"Hash":"64a8f9705bb575c3877c9c3e16d3fc4c0fcccdf733697a3db8e6da5d73afbdab","Text":"array_sample ( array anyarray, n integer ) → anyarray","Returns":"anyarray","Payload":{"description":"Returns an array of n items randomly selected from array. n may not exceed the length of array's first dimension. If array is multi-dimensional, an “item” is a slice having a given first subscript.","description_html":"Returns an array of \u003cem class=\"parameter\"\u003e\u003ccode\u003en\u003c/code\u003e\u003c/em\u003e items randomly selected from \u003cem class=\"parameter\"\u003e\u003ccode\u003earray\u003c/code\u003e\u003c/em\u003e. \u003cem class=\"parameter\"\u003e\u003ccode\u003en\u003c/code\u003e\u003c/em\u003e may not exceed the length of \u003cem class=\"parameter\"\u003e\u003ccode\u003earray\u003c/code\u003e\u003c/em\u003e's first dimension. If \u003cem class=\"parameter\"\u003e\u003ccode\u003earray\u003c/code\u003e\u003c/em\u003e is multi-dimensional, an \u003cspan class=\"quote\"\u003e“\u003cspan class=\"quote\"\u003eitem\u003c/span\u003e”\u003c/span\u003e is a slice having a given first subscript.","description_zh":"","description_zh_html":"","examples":[{"expr":"array_sample(ARRAY[1,2,3,4,5,6], 3)","result":"{2,6,1}"},{"expr":"array_sample(ARRAY[[1,2],[3,4],[5,6]], 2)","result":"{{5,6},{1,2}}"}],"html":"\u003ccode class=\"function\"\u003earray_sample\u003c/code\u003e ( \u003cem class=\"parameter\"\u003e\u003ccode\u003earray\u003c/code\u003e\u003c/em\u003e \u003ccode class=\"type\"\u003eanyarray\u003c/code\u003e, \u003cem class=\"parameter\"\u003e\u003ccode\u003en\u003c/code\u003e\u003c/em\u003e \u003ccode class=\"type\"\u003einteger\u003c/code\u003e ) → \u003ccode class=\"returnvalue\"\u003eanyarray\u003c/code\u003e","returns":"anyarray","text":"array_sample ( array anyarray, n integer ) → anyarray","zh_from":""}}],"Spellings":null,"SQLState":null,"Evidence":null}