WOLFRAM

Wolfram 语言与系统参考资料中心

ExternalStorageObject[location]

表示存储在外部 location 的文件.

ExternalStorageObject[assoc]

表示存储在由关联 assoc 的元素所指定的外部服务中的文件.

ExternalStorageObject[location,assoc]

表示存储在外部 location 的文件，由 assoc 给出额外的元素.

更多信息
Details and Options Details and Options
范例  
基本范例  
范围  
单个文件  
多个文件  
应用  
属性和关系  
CopyFile  
属性  
BucketName  
CID  
FileHash  
Path  
Properties  
ResourceType  
Service  
参见
相关指南
相关链接
历史
按以下格式引用：

ExternalStorageObject

ExternalStorageObject[location]

表示存储在外部 location 的文件.

ExternalStorageObject[assoc]

表示存储在由关联 assoc 的元素所指定的外部服务中的文件.

ExternalStorageObject[location,assoc]

表示存储在外部 location 的文件，由 assoc 给出额外的元素.

更多信息

  • 由 ExternalStorageUpload 和 ExternalStoragePut 返回 ExternalStorageObject. 它是 ExternalStorageDownload、ExternalStorageGet 和 CopyFile 的有效输入.
  • location 的可能的形式包括：
  • "CID"IPFS 内容标识符 (CID)
    "path"外部存储服务（如 Dropbox、Amazon S3）中的路径
    "bucket/key"外部存储服务（如 Amazon S3）中的存储桶名称和密钥
    "uri"外部存储服务的 URI（如 Amazon S3 URI）
    {"location1","location2",…}外部存储服务中的路径、密钥或 URI 列表
  • 在 ExternalStorageObject[assoc] 中，关联 assoc 可以包含具有以下键的元素：
  • "CID"InterPlanetary File System (IPFS) 内容标识符
    "Path"到外部服务中文件的路径或路径列表
    "BucketName"外部存储服务（如 Amazon S3）中的存储桶名称
    "ExternalStorageBase"外部存储服务
  • ExternalStorageObject[...]["Properties"] 返回外部存储对象的所有可用属性的列表.
  • ExternalStorageObject[...][prop] 返回外部存储对象的属性 prop.
  • 支持的属性包括：
  • "BucketName"Amazon S3 存储桶名称
    "CID"InterPlanetary File System (IPFS) 内容标识符
    "FileHash"文件的哈希
    "Path"到外部服务中文件的路径
    "ResourceType"资源的类型 ("SingleFile"、"MultipleFiles")
    "Service"外部存储服务
  • ExternalStorageObject 创建对文件的引用. 文件不必已存在.

范例

打开所有单元 关闭所有单元

基本范例  (4)

用默认的 $ExternalStorageBase 创建 ExternalStorageObject：

Wolfram Language code: ExternalStorageObject[]

通过用位置提供 InterPlanetary 文件系统 (IPFS) 内容标识符创建 ExternalStorageObject：

Wolfram Language code: ExternalStorageObject["QmfPE7vZ6X8jKC7N8TSDfHuabBjW7bwbnvCAVm6eEPPatf"]

通过提供 Dropbox 中单个文件的路径和在关联中用 "ExternalStorageBase" 值表示的服务来创建 ExternalStorageObject：

Wolfram Language code: ExternalStorageObject["spikey.png", <|"ExternalStorageBase" -> "Dropbox"|>]

通过提供 Amazon S3 存储桶中多个文件的路径创建 ExternalStorageObject：

Wolfram Language code: ExternalStorageObject[{"image1.jpg", "image2.jpg", "image3.jpg"}, <|"BucketName" -> "MyBucket", "ExternalStorageBase" -> "AmazonS3"|>]

范围  (6)

单个文件  (4)

通过提供 InterPlanetary File System (IPFS) 内容标识符作为位置创建 ExternalStorageObject：

Wolfram Language code: ExternalStorageObject["QmfPE7vZ6X8jKC7N8TSDfHuabBjW7bwbnvCAVm6eEPPatf"]

通过提供 Dropbox 中单个文件的路径和在关联中用 "ExternalStorageBase" 值表示的服务来创建 ExternalStorageObject：

Wolfram Language code: ExternalStorageObject["spikey.png", <|"ExternalStorageBase" -> "Dropbox"|>]

指定路径为 "Path" 键的值给出同样的结果：

Wolfram Language code: ExternalStorageObject[<|"Path" -> "spikey.png", "ExternalStorageBase" -> "Dropbox"|>]

通过提供到 Amazon S3 存储桶中单个文件的路径创建 ExternalStorageObject：

Wolfram Language code: ExternalStorageObject["image1.jpg", <|"BucketName" -> "MyBucket", "ExternalStorageBase" -> "AmazonS3"|>]

指定路径为 "Path" 键的值给出同样的结果：

Wolfram Language code: ExternalStorageObject[<|"BucketName" -> "MyBucket", "Path" -> "image1.jpg", "ExternalStorageBase" -> "AmazonS3"|>]

通过提供 Amazon S3 URI 创建 ExternalStorageObject：

Wolfram Language code: ExternalStorageObject["s3://MyBucket/image1.jpg", <|"ExternalStorageBase" -> "AmazonS3"|>]

多个文件  (2)

通过提供到 Amazon S3 创建 ExternalStorageObject：

Wolfram Language code: ExternalStorageObject[{"image1.jpg", "image2.jpg", "image3.jpg"}, <|"BucketName" -> "MyBucket", "ExternalStorageBase" -> "AmazonS3"|>]

指定路径为 "Path" 键的值给出同样的结果：

Wolfram Language code: ExternalStorageObject[<|"BucketName" -> "MyBucket", "Path" -> {"image1.jpg", "image2.jpg", "image3.jpg"}, "ExternalStorageBase" -> "AmazonS3"|>]

通过提供与特定存储桶关联的多个 Amazon S3 URI 创建 ExternalStorageObject：

Wolfram Language code: ExternalStorageObject[{"s3://MyBucket/image1.jpg", "s3://MyBucket/image2.jpg", "s3://MyBucket/image3.jpg"}, <|"ExternalStorageBase" -> "AmazonS3"|>]

应用  (3)

将算出的值保存到 InterPlanetary 文件系统 (IPFS) 中：

Wolfram Language code: ExternalStoragePut[Range[10]]

获取保存在 InterPlanetary 文件系统 (IPFS) 中的表达式：

Wolfram Language code: ExternalStorageGet[ExternalStorageObject["QmT2yUde9NFsX6J7y97VGu8CeA5tLEshu5V7PVHeRqUcDA", Association["ExternalStorageBase" -> "IPFS", "FileHash" -> "8ff89c0fb7e25244a4bbe9640f7b3170"]]]

从 InterPlanetary 文件系统 (IPFS) 下载文件：

Wolfram Language code: file = ExternalStorageDownload[ExternalStorageObject["Qmd1HkTU55zaCDnX2wbnVoq15aPHdutn8c3epuJFAt4dgf", Association["ExternalStorageBase" -> "IPFS", "FileHash" -> "38cb6f3cd68c6c723591a8a385732560"]]]

导入下载的内容：

Wolfram Language code: Import[file]

从 Amazon S3 存储桶下载多个文件：

Wolfram Language code: files = ExternalStorageDownload[ExternalStorageObject[{"/wolfram-bucket/Cali.jpg", "/wolfram-bucket/Choriza2.jpg", "/wolfram-bucket/Choriza.jpg", "/wolfram-bucket/ThaiCali.jpg", "/wolfram-bucket/zip.jpeg"}, Association["BucketName" -> "/wolfram-bucket", "Path" -> {"Cali.jpg", "Choriza2.jpg", "Choriza.jpg", "ThaiCali.jpg", "zip.jpeg"}, "ExternalStorageBase" -> "AmazonS3"]]]
Wolfram Language code: Import /@ files

属性和关系  (11)

CopyFile  (1)

CopyFile 也支持将 ExternalStorageObject 作为文件指定，以便将其下载到本地路径：

Wolfram Language code: CopyFile[ExternalStorageObject["Qmd1HkTU55zaCDnX2wbnVoq15aPHdutn8c3epuJFAt4dgf", Association["ExternalStorageBase" -> "IPFS", "FileHash" -> "38cb6f3cd68c6c723591a8a385732560"]], "~/Downloads/Wolfram/Spikey.png"]
Wolfram Language code: Import[%]

属性  (10)

BucketName  (1)

获取表示存储在 Amazon S3 中的文件的 ExternalStorageObject 的存储桶名称：

Wolfram Language code: ExternalStorageObject[{"image1.jpg", "image2.jpg", "image3.jpg"}, Association["BucketName" -> "MyBucket", "ExternalStorageBase" -> "AmazonS3"]]["BucketName"]

CID  (1)

获取表示存储在 IPFS 中的文件的 ExternalStorageObject 的内容标识符：

Wolfram Language code: ExternalStorageObject["QmT2yUde9NFsX6J7y97VGu8CeA5tLEshu5V7PVHeRqUcDA", Association["ExternalStorageBase" -> "IPFS", "FileHash" -> "8ff89c0fb7e25244a4bbe9640f7b3170"]]["CID"]

FileHash  (1)

获取表示存储在 IPFS 中的文件的 ExternalStorageObject 的文件的哈希：

Wolfram Language code: ExternalStorageObject["QmT2yUde9NFsX6J7y97VGu8CeA5tLEshu5V7PVHeRqUcDA", Association["ExternalStorageBase" -> "IPFS", "FileHash" -> "8ff89c0fb7e25244a4bbe9640f7b3170"]]["FileHash"]

Path  (2)

获取表示存储在 Dropbox 中的文件的 ExternalStorageObject 的路径：

Wolfram Language code: ExternalStorageObject["/WolframUploads/externalstorage-f169dda9-1909-4188-8a5d-fd9afb944a0d", Association["ExternalStorageBase" -> "Dropbox"]]["Path"]

获取存储在 Amazon S3 存储桶中的多个文件的路径：

Wolfram Language code: ExternalStorageObject[{"image1.jpg", "image2.jpg", "image3.jpg"}, Association["BucketName" -> "/MyBucket", "Path" -> {"image1.jpg", "image2.jpg", "image3.jpg"}, "ExternalStorageBase" -> "AmazonS3"]]["Path"]

Properties  (3)

获取表示存储在 IPFS 中的文件的 ExternalStorageObject 的属性：

Wolfram Language code: ExternalStorageObject["QmT2yUde9NFsX6J7y97VGu8CeA5tLEshu5V7PVHeRqUcDA", Association["ExternalStorageBase" -> "IPFS", "FileHash" -> "8ff89c0fb7e25244a4bbe9640f7b3170"]]["Properties"]

获取表示存储在 Dropbox 中的文件的 ExternalStorageObject 的属性：

Wolfram Language code: ExternalStorageObject["/WolframUploads/externalstorage-f169dda9-1909-4188-8a5d-fd9afb944a0d", Association["ExternalStorageBase" -> "Dropbox"]]["Properties"]

获取表示存储在Amazon S3 中的文件的 ExternalStorageObject 的属性：

Wolfram Language code: ExternalStorageObject[{"image1.jpg", "image2.jpg", "image3.jpg"}, Association["BucketName" -> "/MyBucket", "Path" -> {"image1.jpg", "image2.jpg", "image3.jpg"}, "ExternalStorageBase" -> "AmazonS3"]]["Properties"]

ResourceType  (1)

获取 ExternalStorageObject 的资源类型：

Wolfram Language code: ExternalStorageObject[{"image1.jpg", "image2.jpg", "image3.jpg"}, Association["BucketName" -> "/MyBucket", "Path" -> {"image1.jpg", "image2.jpg", "image3.jpg"}, "ExternalStorageBase" -> "AmazonS3"]]["ResourceType"]

Service  (1)

获取与 ExternalStorageObject 关联的外表存储服务：

Wolfram Language code: ExternalStorageObject[{"image1.jpg", "image2.jpg", "image3.jpg"}, Association["BucketName" -> "MyBucket", "ExternalStorageBase" -> "AmazonS3"]]["Service"]
Wolfram Research (2020)，ExternalStorageObject，Wolfram 语言函数，https://reference.wolfram.com/language/ref/ExternalStorageObject.html.

文本

Wolfram Research (2020)，ExternalStorageObject，Wolfram 语言函数，https://reference.wolfram.com/language/ref/ExternalStorageObject.html.

CMS

Wolfram 语言. 2020. "ExternalStorageObject." Wolfram 语言与系统参考资料中心. Wolfram Research. https://reference.wolfram.com/language/ref/ExternalStorageObject.html.

APA

Wolfram 语言. (2020). ExternalStorageObject. Wolfram 语言与系统参考资料中心. 追溯自 https://reference.wolfram.com/language/ref/ExternalStorageObject.html 年

BibTeX

@misc{reference.wolfram_2026_externalstorageobject, author="Wolfram Research", title="{ExternalStorageObject}", year="2020", howpublished="\url{https://reference.wolfram.com/language/ref/ExternalStorageObject.html}", note=[Accessed: 05-September-2026]}

BibLaTeX

@online{reference.wolfram_2026_externalstorageobject, organization={Wolfram Research}, title={ExternalStorageObject}, year={2020}, url={https://reference.wolfram.com/language/ref/ExternalStorageObject.html}, note=[Accessed: 05-September-2026]}