Získání aktivity metadat v Azure Data Factory nebo Azure Synapse Analytics

VZTAHUJE SE NA: Azure Data Factory Azure Synapse Analytics

Tip

Pro ekvivalentní aktivitu v Data Factory v Microsoft Fabric viz Získat metadata aktivitu.

Pomocí aktivity Získat metadata můžete načíst metadata všech dat v Azure Data Factory nebo kanálu Synapse. Pomocí výstupu aktivity Získat metadata v podmíněných výrazech můžete provést ověření nebo využívat metadata v následných aktivitách.

Vytvoření aktivity Získání metadat pomocí uživatelského rozhraní

Pokud chcete v kanálu použít aktivitu Získat metadata, proveďte následující kroky:

Vyhledejte Získat metadata v podokně Aktivity kanálu a přetáhněte aktivitu Získat metadata na plátno kanálu.
Pokud ještě není vybraná, vyberte na plátně novou aktivitu Získat metadata a její podrobnosti upravte na kartě Nastavení .
Zvolte datovou sadu nebo vytvořte novou pomocí tlačítka Nový. Pak můžete zadat možnosti filtru a přidat sloupce z dostupných metadat datové sady.
Výstup aktivity použijte jako vstup do jiné aktivity, jako je aktivita Switch v tomto příkladu. Na výstup aktivity metadat můžete odkazovat kdekoli, kde je dynamický obsah podporován v jiné aktivitě.
V editoru dynamického obsahu vyberte výstup aktivity Získat metadata, na který chcete odkazovat v jiné aktivitě.

Podporované funkce

Aktivita Získat metadata přebírá datovou sadu jako vstup a vrací informace o metadatech jako výstup. V současné době jsou podporovány následující konektory a odpovídající metadata pro načtení. Maximální velikost vrácených metadat je 4 MB.

Podporované konektory

File Storage

Konektor/Metadata	název položky (soubor nebo složka)	typ položky (soubor nebo složka)	velikost (soubor)	vytvořeno (soubor nebo složka)	poslední úpravy¹ (soubor nebo složka)	childItems (složka)	contentMD5 (soubor)	struktura² (soubor)	columnCount² (soubor)	existuje³ (soubor nebo složka)
Amazon S3	√/√	√/√	√	x/x	√/√	√	x	√	√	√/√
Úložiště kompatibilní s Amazon S3	√/√	√/√	√	x/x	√/√	√	x	√	√	√/√
Cloudové úložiště Googlu	√/√	√/√	√	x/x	√/√	√	x	√	√	√/√
Cloudové úložiště Oracle	√/√	√/√	√	x/x	√/√	√	x	√	√	√/√
Azure Blob Storage	√/√	√/√	√	x/x	√/√	√	√	√	√	√/√
Azure Data Lake Storage Gen1	√/√	√/√	√	x/x	√/√	√	x	√	√	√/√
Azure Data Lake Storage Gen2	√/√	√/√	√	x/x	√/√	√	√	√	√	√/√
Azure Files	√/√	√/√	√	√/√	√/√	√	x	√	√	√/√
Microsoft Fabric Lakehouse	√/√	√/√	√	x/x	√/√	√	√	√	√	√/√
Systém souborů	√/√	√/√	√	√/√	√/√	√	x	√	√	√/√
SFTP	√/√	√/√	√	x/x	√/√	√	x	√	√	√/√
FTP	√/√	√/√	√	x/x	x/x	√	x	√	√	√/√

¹ Metadata lastModified:

Pro Amazon S3, Amazon S3 Compatible Storage, Google Cloud Storage a Oracle Cloud Storage platí pro kontejner a klíč, lastModified ale ne pro virtuální složku, a exists platí pro kontejner a klíč, ale ne pro předponu nebo virtuální složku.
Pro Azure Blob Storage platí lastModified pro kontejner a objekt blob, ale ne pro virtuální složku.

² Metadata structure a columnCount nejsou podporována při získávání metadat ze souborů Binary, JSON nebo XML.

³ Metadata exists: Pro Amazon S3, Amazon S3 Compatible Storage, Google Cloud Storage a Oracle Cloud Storage platí pro kontejner a klíč, exists ale ne pro předponu nebo virtuální složku.

Mějte na paměti následující body:

Při použití aktivity Získat metadata u složky se ujistěte, že máte oprávnění LIST/EXECUTE k dané složce.
Filtr zástupných znaků u složek a souborů není u aktivity Získat metadata podporována.
modifiedDatetimeStart a modifiedDatetimeEnd sada filtrů na konektoru:
- Tyto dvě vlastnosti slouží k filtrování podřízených položek při získávání metadat ze složky. Nevztahuje se na získání metadat ze souboru.
- Při použití childItems takového filtru obsahuje ve výstupu pouze soubory upravené v zadaném rozsahu, ale ne složky.
- Pokud chcete takový filtr použít, aktivita GetMetadata vytvoří výčet všech souborů v zadané složce a zkontroluje čas změny. Nepoužívejte odkazování na složku s velkým počtem souborů, i když je očekávaný počet kvalifikovaných souborů malý.

Relační databáze

Konektor/Metadata	struktura	početSloupců	existuje
Amazon RDS pro SQL Server	√	√	√
Azure SQL Database	√	√	√
Azure SQL Managed Instance	√	√	√
Azure Synapse Analytics	√	√	√
SQL Server	√	√	√

Možnosti metadat

V seznamu polí aktivity Získat metadata můžete zadat následující typy metadat, které načtou odpovídající informace:

Typ metadat	Popis
název položky	Název souboru nebo složky.
typ položky	Typ souboru nebo složky Vrácená hodnota je `File` nebo `Folder`.
velikost	Velikost souboru v bajtech Platí jenom pro soubory.
vytvořeno	Vytvořili jste datum a čas souboru nebo složky.
poslední změna	Datum poslední změny souboru nebo složky.
childItems	Seznam podsložek a souborů v dané složce Platí jenom pro složky. Vrácená hodnota je seznam názvu a typu každé podřízené položky.
contentMD5	MD5 souboru. Platí jenom pro soubory.
struktura	Datová struktura tabulky souboru nebo relační databáze Vrácená hodnota je seznam názvů sloupců a typů sloupců.
početSloupců	Počet sloupců v souboru nebo relační tabulce
existuje	Bez ohledu na to, jestli soubor, složka nebo tabulka existuje. Pokud `exists` je zadaná v seznamu polí Získat metadata, aktivita se nezdaří ani v případě, že soubor, složka nebo tabulka neexistují. Místo toho se `exists: false` vrátí ve výstupu.

Tip

Pokud chcete ověřit, že soubor, složka nebo tabulka existuje, zadejte exists v seznamu polí aktivity Získat metadata. Výsledek můžete pak zkontrolovat exists: true/false ve výstupu aktivity. Pokud exists není v seznamu polí zadána, aktivita Získat metadata selže, pokud se objekt nenajde.

Poznámka:

Když získáte metadata z úložišť souborů a nakonfigurujete modifiedDatetimeStart nebo modifiedDatetimeEnd, childItems ve výstupu zahrnou pouze soubory v zadané cestě, které mají čas poslední změny v zadaném rozsahu. Položky v podsložkách nejsou zahrnuty.

Poznámka:

Pokud chcete v seznamu polí Struktura poskytnout skutečnou datovou strukturu pro text s oddělovači a datové sady formátu Excel, musíte povolit vlastnost First Row as Header, která je podporována pouze pro tyto zdroje dat.

Syntaxe

Aktivita získání metadat

{
    "name":"MyActivity",
    "type":"GetMetadata",
    "dependsOn":[

    ],
    "policy":{
        "timeout":"7.00:00:00",
        "retry":0,
        "retryIntervalInSeconds":30,
        "secureOutput":false,
        "secureInput":false
    },
    "userProperties":[

    ],
    "typeProperties":{
        "dataset":{
            "referenceName":"MyDataset",
            "type":"DatasetReference"
        },
        "fieldList":[
            "size",
            "lastModified",
            "structure"
        ],
        "storeSettings":{
            "type":"AzureBlobStorageReadSettings"
        },
        "formatSettings":{
            "type":"JsonReadSettings"
        }
    }
}

Dataset

{
    "name":"MyDataset",
    "properties":{
        "linkedServiceName":{
            "referenceName":"AzureStorageLinkedService",
            "type":"LinkedServiceReference"
        },
        "annotations":[

        ],
        "type":"Json",
        "typeProperties":{
            "location":{
                "type":"AzureBlobStorageLocation",
                "fileName":"file.json",
                "folderPath":"folder",
                "container":"container"
            }
        }
    }
}

Vlastnosti typu

Aktivita Získat metadata může v současné době vracet následující typy informací o metadatech:

Vlastnost	Popis	Povinné
seznam polí	Požadované typy informací o metadatech. Podrobnosti o podporovaných metadatech najdete v části Možnosti metadat tohoto článku.	Ano
datová sada	Referenční datová sada, jejíž metadata se mají načíst aktivitou Získat metadata. Informace o podporovaných konektorech najdete v části Možnosti. Podrobnosti o syntaxi datové sady najdete v konkrétních článcích o konektorech.	Ano
nastavení formátu	Použít při použití datové sady typů formátu	Ne
nastavení úložiště	Použít při použití datové sady typů formátu	Ne

Ukázkový výstup

Výsledky získání metadat se zobrazují ve výstupu aktivity. Následují dvě ukázky s rozsáhlými možnostmi metadat. Pokud chcete výsledky použít v následné aktivitě, použijte tento vzor: @{activity('MyGetMetadataActivity').output.itemName}.

Získání metadat souboru

{
  "exists": true,
  "itemName": "test.csv",
  "itemType": "File",
  "size": 104857600,
  "lastModified": "2017-02-23T06:17:09Z",
  "created": "2017-02-23T06:17:09Z",
  "contentMD5": "cMauY+Kz5zDm3eWa9VpoyQ==",
  "structure": [
    {
        "name": "id",
        "type": "Int64"
    },
    {
        "name": "name",
        "type": "String"
    }
  ],
  "columnCount": 2
}

Získání metadat složky

{
  "exists": true,
  "itemName": "testFolder",
  "itemType": "Folder",
  "lastModified": "2017-02-23T06:17:09Z",
  "created": "2017-02-23T06:17:09Z",
  "childItems": [
    {
      "name": "test.avro",
      "type": "File"
    },
    {
      "name": "folder hello",
      "type": "Folder"
    }
  ]
}

Další informace o dalších podporovaných aktivitách toku řízení:

Váš názor

Byla tato stránka užitečná?

Last updated on 2026-08-13