{"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","derived_content_hash":"824008d59a96c54204ee3920bd723e0de0f44fa1ff08e78fd05369ce81d4cbab","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"],"repair_provenance":{"original_source_revision":"2026-09-14T13:14:25.684213+00:00@99e6866c","receipt_sha256":"c42cd6b2457bd536be690efd20464ee2c29969fe498a7cac7234b9830ea6ca75","repair":"wiki-repair-20261023"},"signature":"array_sample ( array anyarray, n integer ) → anyarray","signature_count":1,"slug":"array-sample","source_rev":"wiki-repair-20261023:d2d34a7b6e69d717e43fdd689803c9a55200d492142fd5cda5cd8db5abf84e86","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":"wiki-repair-20261023:d2d34a7b6e69d717e43fdd689803c9a55200d492142fd5cda5cd8db5abf84e86","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":"从 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是具有给定第一维下标的一个切片。","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":"从 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是具有给定第一维下标的一个切片。","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":"same-version-pgdoc"}],"translation_provenance":{"inputs":[{"kind":"current-pgdoc-translation","path":"/Users/vonng/pgsty/pgdoc/zh/18/html/functions-array.html","sha256":"a25a0710e8f84e027ef945e85452074399887341e22d79542584f9c646b8f076"}],"kind":"same-version-pgdoc","locale":"zh-Hans","source_revision":"b1b500221dbe5437cfca004d6b04d3f6e422765d","version":"18"},"zh_from":"same-version-pgdoc"},"ManualEvidence":{"doc":{"anchor":"ARRAY-FUNCTIONS-TABLE","file":"functions-array.html","slug":"18"}},"MeasuredEvidence":{}},"Text":{"Collection":"func","Key":"array-sample","SourceDatabase":"center","Version":"18","Locale":"en","Title":"array_sample","Summary":"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.","BodyHTML":"Returns an array of \u003cem\u003e\u003ccode\u003en\u003c/code\u003e\u003c/em\u003e items randomly selected from \u003cem\u003e\u003ccode\u003earray\u003c/code\u003e\u003c/em\u003e. \u003cem\u003e\u003ccode\u003en\u003c/code\u003e\u003c/em\u003e may not exceed the length of \u003cem\u003e\u003ccode\u003earray\u003c/code\u003e\u003c/em\u003e\u0026#39;s first dimension. If \u003cem\u003e\u003ccode\u003earray\u003c/code\u003e\u003c/em\u003e is multi-dimensional, an \u003cspan\u003e“\u003cspan\u003eitem\u003c/span\u003e”\u003c/span\u003e is a slice having a given first subscript.","SourceRevision":"wiki-repair-20261023:d2d34a7b6e69d717e43fdd689803c9a55200d492142fd5cda5cd8db5abf84e86","ContentHash":"8d85078ba9c3c9d2570ba49e0d80e263aca309e11f0e712ccb2c3a0b1d740d4b","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.","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":"从 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是具有给定第一维下标的一个切片。","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":"same-version-pgdoc"}]}},"RequestedLocale":"en","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":"从 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是具有给定第一维下标的一个切片。","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":"same-version-pgdoc"}}],"Spellings":null,"SQLState":null,"Evidence":null}
