Tworzenie połączenia danych usługi Event Grid dla usługi Azure Data Explorer

Artykuł
02/29/2024

W tym artykule dowiesz się, jak pozyskiwać obiekty blob z konta magazynu do usługi Azure Data Explorer przy użyciu połączenia danych usługi Event Grid. Utworzysz połączenie danych usługi Event Grid, które ustawia subskrypcję Azure Event Grid. Subskrypcja usługi Event Grid kieruje zdarzenia z konta magazynu do usługi Azure Data Explorer za pośrednictwem Azure Event Hubs.

Uwaga

Maksymalny rozmiar pliku obsługiwany w pozyskiwaniu wynosi 6 GB. Zaleceniem jest pozyskiwanie plików z zakresu od 100 MB do 1 GB.

Aby dowiedzieć się, jak utworzyć połączenie przy użyciu zestawów SDK kusto, zobacz Tworzenie połączenia danych usługi Event Grid z zestawami SDK.

Aby uzyskać ogólne informacje na temat pozyskiwania do usługi Azure Data Explorer z usługi Event Grid, zobacz Łączenie z usługą Event Grid.

Uwaga

Aby uzyskać najlepszą wydajność za pomocą połączenia usługi Event Grid, ustaw rawSizeBytes właściwość pozyskiwania za pośrednictwem metadanych obiektu blob. Aby uzyskać więcej informacji, zobacz właściwości pozyskiwania.

Wymagania wstępne

Subskrypcja platformy Azure. Utwórz bezpłatne konto platformy Azure.
Baza danych i klaster usługi Azure Data Explorer. Utwórz klaster i bazę danych.
Tabela docelowa. Utwórz tabelę lub użyj istniejącej tabeli.
Mapowanie pozyskiwania dla tabeli.
Konto magazynu. Subskrypcję powiadomień usługi Event Grid można ustawić na kontach usługi Azure Storage dla BlobStorage, StorageV2lub Data Lake Storage Gen2.
Zarejestruj dostawcę zasobów usługi Event Grid.

Tworzenie połączenia danych usługi Event Grid

W tej sekcji ustanowić połączenie między usługą Event Grid i tabelą usługi Azure Data Explorer.

Przejdź do klastra usługi Azure Data Explorer w Azure Portal.
W obszarze Dane wybierz pozycję Bazy danych>TestDatabase.
W obszarze Ustawienia wybierz pozycję Połączenia danych, a następnie wybierz pozycję Dodaj połączenie> danychEvent Grid (Blob Storage).

Wypełnij formularz połączenia danych usługi Event Grid następującymi informacjami:

Ustawienie	Sugerowana wartość	Opis pola
Nazwa połączenia danych	test-grid-connection	Nazwa połączenia, które chcesz utworzyć w usłudze Azure Data Explorer. Nazwy połączeń danych mogą zawierać tylko znaki alfanumeryczne, kreski i kropki oraz maksymalnie 40 znaków.
Subskrypcja konta magazynu	Identyfikator Twojej subskrypcji	Identyfikator subskrypcji, w którym znajduje się twoje konto magazynu.
Typ zdarzenia	Utworzono obiekt blob lub zmieniono nazwę obiektu blob	Typ zdarzenia wyzwalającego pozyskiwanie. Zmiana nazwy obiektu blob jest obsługiwana tylko w przypadku magazynu ADLSv2. Aby zmienić nazwę obiektu blob, przejdź do obiektu blob w Azure Portal, kliknij prawym przyciskiem myszy obiekt blob i wybierz polecenie Zmień nazwę. Obsługiwane typy to: Microsoft.Storage.BlobCreated lub Microsoft.Storage.BlobRenamed.
Konto magazynu	gridteststorage1	Nazwa utworzonego wcześniej konta magazynu.
Tworzenie zasobów	Automatyczne	Włączenie automatycznego tworzenia zasobów oznacza, że usługa Azure Data Explorer tworzy subskrypcję usługi Event Grid, przestrzeń nazw usługi Event Hubs i usługę Event Hubs. W przeciwnym razie należy ręcznie utworzyć te zasoby, aby zapewnić utworzenie połączenia danych. Zobacz Ręczne tworzenie zasobów na potrzeby pozyskiwania usługi Event Grid

Opcjonalnie można śledzić określone tematy usługi Event Grid. Filtry dla powiadomień ustaw w następujący sposób:
- Pole prefiksu jest prefiksemliterału tematu. Gdy zastosowany wzorzec zaczyna się od, może obejmować wiele kontenerów, folderów lub obiektów blob. Symbole wieloznaczne nie są dozwolone.
  - Aby zdefiniować filtr w kontenerze obiektów blob, pole musi być ustawione w następujący sposób: /blobServices/default/containers/[container prefix].
  - Aby zdefiniować filtr w prefiksie obiektu blob (lub folderze w usłudze Azure Data Lake Gen2), należy ustawić pole w następujący sposób: /blobServices/default/containers/[container name]/blobs/[folder/blob prefix].
- Pole sufiksu jest sufiksemliterału obiektu blob. Symbole wieloznaczne nie są dozwolone.
- Pole Uwzględniana wielkość liter wskazuje, czy filtry prefiksów i sufiksów są uwzględniane wielkość liter
Aby uzyskać więcej informacji na temat filtrowania zdarzeń, zobacz Zdarzenia usługi Blob Storage.

Opcjonalnie możesz określić ustawienia routingu danych zgodnie z poniższymi informacjami. Nie musisz określać wszystkich ustawień routingu danych. Ustawienia częściowe są również akceptowane.

Ustawienie	Sugerowana wartość	Opis pola
Zezwalaj na kierowanie danych do innych baz danych (połączenie danych z wieloma bazami danych)	Nie zezwalaj	Włącz tę opcję, jeśli chcesz zastąpić domyślną docelową bazę danych skojarzona z połączeniem danych. Aby uzyskać więcej informacji na temat routingu bazy danych, zobacz Routing zdarzeń.
Nazwa tabeli	TestTable	Tabela utworzona przez Ciebie w obszarze TestDatabase.
Format danych	JSON	Obsługiwane formaty to APACHEAVRO, Avro, CSV, JSON, ORC, PARQUET, PSV, RAW, SCSV, SOHSV, TSV, TSVE, TXT i W3CLOG. Obsługiwane opcje kompresji to Zip i Gzip.
Nazwa mapowania	TestTable_mapping	Mapowanie utworzone w bazie danych TestDatabase, które mapuje dane przychodzące na nazwy kolumn i typy danych tabeli TestTable. Jeśli nie zostanie określone, mapowanie danych tożsamości pochodzące ze schematu tabeli jest generowane automatycznie.
Ignoruj błędy formatu	Ignoruj	Włącz tę opcję, jeśli chcesz zignorować błędy formatu dla formatu danych JSON.

Uwaga

Nazwy tabel i mapowań są uwzględniane w wielkości liter.

Opcjonalnie w obszarze Ustawienia zaawansowane można określić typ tożsamości zarządzanej , który jest używany przez połączenie danych. Domyślnie jest zaznaczona opcja Przypisana przez system .

Jeśli wybierzesz opcję Przypisane przez użytkownika, musisz ręcznie przypisać tożsamość zarządzaną. Jeśli wybierzesz użytkownika, który nie jest jeszcze przypisany do klastra, zostanie on automatycznie przypisany. Aby uzyskać więcej informacji, zobacz Konfigurowanie tożsamości zarządzanych dla klastra usługi Azure Data Explorer.

W przypadku wybrania pozycji Brak konto magazynu i centrum zdarzeń są uwierzytelniane za pośrednictwem parametrów połączenia. Ta metoda nie jest zalecana.

Wybierz pozycję Utwórz

Przejdź do konta magazynu w Azure Portal.
Wybierz pozycję Zdarzenia.
Na karcie Wprowadzenie wybierz kartę Azure Data Explorer.
Na kafelku Tworzenie ciągłego pozyskiwania danych wybierz pozycję Utwórz.

Wybieranie miejsca docelowego do kierowania zdarzeń do

Wybierz klaster, w którym chcesz pozyskać dane.
Wybierz docelową bazę danych.
Wybierz pozycję Wybierz.

Tworzenie połączenia danych

Wypełnij formularz, używając poniższych informacji:

Ustawienie	Sugerowana wartość	Opis pola
Nazwa połączenia danych	test-grid-connection	Nazwa połączenia, które chcesz utworzyć w usłudze Azure Data Explorer.
Subskrypcja konta magazynu	Identyfikator Twojej subskrypcji	Identyfikator subskrypcji, w którym znajduje się twoje konto magazynu.
Typ zdarzenia	Utworzono obiekt blob lub zmieniono nazwę obiektu blob	Typ zdarzenia wyzwalającego pozyskiwanie. Zmiana nazwy obiektu blob jest obsługiwana tylko w przypadku magazynu ADLSv2. Aby zmienić nazwę obiektu blob, przejdź do obiektu blob w Azure Portal, kliknij prawym przyciskiem myszy obiekt blob i wybierz polecenie Zmień nazwę. Obsługiwane typy to: Microsoft.Storage.BlobCreated lub Microsoft.Storage.BlobRenamed.
Konto magazynu	gridteststorage1	Konto magazynu, z którego uzyskiwano dostęp do tego kreatora, jest wypełniane automatycznie.
Tworzenie zasobów	Automatyczne	Włączenie automatycznego tworzenia zasobów oznacza, że usługa Azure Data Explorer tworzy subskrypcję usługi Event Grid, przestrzeń nazw usługi Event Hubs i usługę Event Hubs. W przeciwnym razie należy ręcznie utworzyć te zasoby, aby zapewnić utworzenie połączenia danych. Zobacz Ręczne tworzenie zasobów na potrzeby pozyskiwania usługi Event Grid

Opcjonalnie można śledzić określone tematy usługi Event Grid. Filtry dla powiadomień ustaw w następujący sposób:
- Pole prefiksu jest prefiksemliterału tematu. Gdy zastosowany wzorzec zaczyna się od, może obejmować wiele kontenerów, folderów lub obiektów blob. Symbole wieloznaczne nie są dozwolone.
  - Aby zdefiniować filtr w kontenerze obiektów blob, pole musi być ustawione w następujący sposób: /blobServices/default/containers/[container prefix].
  - Aby zdefiniować filtr w prefiksie obiektu blob (lub folderze w usłudze Azure Data Lake Gen2), należy ustawić pole w następujący sposób: /blobServices/default/containers/[container name]/blobs/[folder/blob prefix].
- Pole sufiksu jest sufiksemliterału obiektu blob. Symbole wieloznaczne nie są dozwolone.
- Pole Uwzględniana wielkość liter wskazuje, czy filtry prefiksów i sufiksów są uwzględniane wielkość liter
Aby uzyskać więcej informacji na temat filtrowania zdarzeń, zobacz Zdarzenia usługi Blob Storage.

Ustawienie	Sugerowana wartość	Opis pola
Zezwalaj na kierowanie danych do innych baz danych (połączenie danych z wieloma bazami danych)	Nie zezwalaj	Włącz tę opcję, jeśli chcesz zastąpić domyślną docelową bazę danych skojarzona z połączeniem danych. Aby uzyskać więcej informacji na temat routingu bazy danych, zobacz Routing zdarzeń.
Nazwa tabeli	TestTable	Tabela utworzona przez Ciebie w obszarze TestDatabase.
Format danych	JSON	Obsługiwane formaty to APACHEAVRO, Avro, CSV, JSON, ORC, PARQUET, PSV, RAW, SCSV, SOHSV, TSV, TSVE, TXT i W3CLOG. Obsługiwane opcje kompresji to Zip i Gzip.
Nazwa mapowania	TestTable_mapping	Mapowanie utworzone w bazie danych TestDatabase, które mapuje dane przychodzące na nazwy kolumn i typy danych tabeli TestTable. Jeśli nie zostanie określone, mapowanie danych tożsamości pochodzące ze schematu tabeli jest generowane automatycznie.
Ignoruj błędy formatu	Ignoruj	Włącz tę opcję, jeśli chcesz zignorować błędy formatu dla formatu danych JSON.

Uwaga

Nazwy tabel i mapowań są uwzględniane w wielkości liter.

Opcjonalnie w obszarze Ustawienia zaawansowane można określić typ tożsamości zarządzanej , który jest używany przez połączenie danych. Domyślnie jest zaznaczona opcja Przypisana przez system .

Jeśli wybierzesz opcję Przypisane przez użytkownika, musisz ręcznie przypisać tożsamość zarządzaną. Jeśli wybierzesz użytkownika, który nie jest jeszcze przypisany do klastra, zostanie on automatycznie przypisany. Aby uzyskać więcej informacji, zobacz Konfigurowanie tożsamości zarządzanych dla klastra usługi Azure Data Explorer.

W przypadku wybrania pozycji Brak konto magazynu i centrum zdarzeń są uwierzytelniane za pośrednictwem parametrów połączenia. Ta metoda nie jest zalecana.

Wybierz przycisk Utwórz.

W poniższym przykładzie przedstawiono szablon usługi Azure Resource Manager do dodawania połączenia danych usługi Event Grid. Szablon można edytować i wdrożyć w Azure Portal przy użyciu formularza.

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "namespaces_eventhubns_name": {
            "type": "string",
            "defaultValue": "eventhubns",
            "metadata": {
                "description": "Specifies the event hub namespace name."
            }
        },
        "EventHubs_eventhubdemo_name": {
            "type": "string",
            "defaultValue": "eventhubdemo",
            "metadata": {
                "description": "Specifies the event hub name."
            }
        },
        "consumergroup_default_name": {
            "type": "string",
            "defaultValue": "$Default",
            "metadata": {
                "description": "Specifies the consumer group of the event hub."
            }
        },
        "StorageAccounts_storagedemo_name": {
            "type": "string",
            "defaultValue": "storagedemo",
            "metadata": {
                "description": "Specifies the storage account name"
            }
        },
        "Clusters_kustocluster_name": {
            "type": "string",
            "defaultValue": "kustocluster",
            "metadata": {
                "description": "Specifies the name of the cluster"
            }
        },
        "databases_kustodb_name": {
            "type": "string",
            "defaultValue": "kustodb",
            "metadata": {
                "description": "Specifies the name of the database"
            }
        },
        "tables_kustotable_name": {
            "type": "string",
            "defaultValue": "kustotable",
            "metadata": {
                "description": "Specifies the name of the table"
            }
        },
        "mapping_kustomapping_name": {
            "type": "string",
            "defaultValue": "kustomapping",
            "metadata": {
                "description": "Specifies the name of the mapping rule"
            }
        },
        "dataformat_type": {
            "type": "string",
            "defaultValue": "csv",
            "metadata": {
                "description": "Specifies the data format"
            }
        },
             "databaseRouting_type": {
            "type": "string",
            "defaultValue": "Single",
            "metadata": {
                "description": "The database routing for the connection. If you set the value to **Single**, the data connection will be routed to a single database in the cluster as specified in the *databaseName* setting. If you set the value to **Multi**, you can override the default target database using the *Database* EventData property."
            }
        },
        "dataconnections_kustodc_name": {
            "type": "string",
            "defaultValue": "kustodc",
            "metadata": {
                "description": "Name of the data connection to create"
            }
        },
        "subscriptionId": {
            "type": "string",
            "defaultValue": "[subscription().subscriptionId]",
            "metadata": {
                "description": "Specifies the subscriptionId of the resources"
            }
        },
        "resourceGroup": {
            "type": "string",
            "defaultValue": "[resourceGroup().name]",
            "metadata": {
                "description": "Specifies the resourceGroup of the resources"
            }
        },
        "location": {
            "type": "string",
            "defaultValue": "[resourceGroup().location]",
            "metadata": {
                "description": "Location for all resources."
            }
        }
    },
    "variables": {
    },
    "resources": [{
            "type": "Microsoft.Kusto/Clusters/Databases/DataConnections",
            "apiVersion": "2022-02-01",
            "name": "[concat(parameters('Clusters_kustocluster_name'), '/', parameters('databases_kustodb_name'), '/', parameters('dataconnections_kustodc_name'))]",
            "location": "[parameters('location')]",
            "kind": "EventGrid",
            "properties": {
                "managedIdentityResourceId": "[resourceId('Microsoft.Kusto/clusters', parameters('clusters_kustocluster_name'))]",
                "storageAccountResourceId": "[resourceId(parameters('subscriptionId'), parameters('resourceGroup'), 'Microsoft.Storage/storageAccounts', parameters('StorageAccounts_storagedemo_name'))]",
                "eventHubResourceId": "[resourceId(parameters('subscriptionId'), parameters('resourceGroup'), 'Microsoft.EventHub/namespaces/eventhubs', parameters('namespaces_eventhubns_name'), parameters('EventHubs_eventhubdemo_name'))]",
                "consumerGroup": "[parameters('consumergroup_default_name')]",
                "tableName": "[parameters('tables_kustotable_name')]",
                "mappingRuleName": "[parameters('mapping_kustomapping_name')]",
                "dataFormat": "[parameters('dataformat_type')]",
                "databaseRouting": "[parameters('databaseRouting_type')]"
            }
        }
    ]
}

Korzystanie z połączenia danych usługi Event Grid

W tej sekcji pokazano, jak wyzwolić pozyskiwanie z Azure Blob Storage lub usługi Azure Data Lake Gen 2 do klastra po utworzeniu obiektu blob lub zmianie nazwy obiektu blob.

Wybierz odpowiednią kartę na podstawie typu zestawu SDK magazynu używanego do przekazywania obiektów blob.

Azure Blob Storage
Azure Data Lake

Poniższy przykładowy kod używa zestawu SDK Azure Blob Storage do przekazania pliku do Azure Blob Storage. Przekazywanie wyzwala połączenie danych usługi Event Grid, które pozyskiwa dane do usługi Azure Data Explorer.

var azureStorageAccountConnectionString = <storage_account_connection_string>;
var containerName = <container_name>;
var blobName = <blob_name>;
var localFileName = <file_to_upload>;
var uncompressedSizeInBytes = <uncompressed_size_in_bytes>;
var mapping = <mapping_reference>;
// Create a new container if it not already exists.
var azureStorageAccount = new BlobServiceClient(azureStorageAccountConnectionString);
var container = azureStorageAccount.GetBlobContainerClient(containerName);
container.CreateIfNotExists();
// Define blob metadata and uploading options.
IDictionary<String, String> metadata = new Dictionary<string, string>();
metadata.Add("rawSizeBytes", uncompressedSizeInBytes);
metadata.Add("kustoIngestionMappingReference", mapping);
var uploadOptions = new BlobUploadOptions
{
    Metadata = metadata,
};
// Upload the file.
var blob = container.GetBlobClient(blobName);
blob.Upload(localFileName, uploadOptions);

Uwaga

Usługa Azure Data Explorer nie usunie obiektów blob po pozyskiwaniu. Zachowaj obiekty blob przez trzy do pięciu dni przy użyciu cyklu życia usługi Azure Blob Storage , aby zarządzać usuwaniem obiektów blob.

Poniższy przykładowy kod używa zestawu SDK usługi Azure Data Lake do przekazania pliku do Data Lake Storage Gen2. Przekazywanie wyzwala połączenie danych usługi Event Grid, które pozyskuje dane do usługi Azure Data Explorer.

var accountName = <storage_account_name>;
var accountKey = <storage_account_key>;
var fileSystemName = <file_system_name>;
var fileName = <file_name>;
var localFileName = <file_to_upload>;
var uncompressedSizeInBytes = <uncompressed_size_in_bytes>;
var mapping = <mapping_reference>;
var sharedKeyCredential = new StorageSharedKeyCredential(accountName, accountKey);
var dfsUri = "https://" + accountName + ".dfs.core.windows.net";
var dataLakeServiceClient = new DataLakeServiceClient(new Uri(dfsUri), sharedKeyCredential);
// Create the filesystem.
var dataLakeFileSystemClient = dataLakeServiceClient.CreateFileSystem(fileSystemName).Value;
// Define file metadata and uploading options.
IDictionary<String, String> metadata = new Dictionary<string, string>();
metadata.Add("rawSizeBytes", uncompressedSizeInBytes);
metadata.Add("kustoIngestionMappingReference", mapping);
var uploadOptions = new DataLakeFileUploadOptions
{
    Metadata = metadata,
    Close = true // Note: The close option triggers the event being processed by the data connection.
};
// Upload the file.
var dataLakeFileClient = dataLakeFileSystemClient.GetFileClient(fileName);
dataLakeFileClient.Upload(localFileName, uploadOptions);

Uwaga

Podczas przekazywania pliku za pomocą zestawu Azure Data Lake SDK początkowe zdarzenie tworzenia pliku ma rozmiar 0, który jest ignorowany przez usługę Azure Data Explorer podczas pozyskiwania danych. Aby zapewnić prawidłowe pozyskiwanie, ustaw Close parametr na truewartość . Ten parametr powoduje, że metoda przekazywania wyzwala zdarzenie FlushAndClose wskazujące, że została wykonana ostateczna aktualizacja i strumień plików jest zamknięty.
Aby zmniejszyć ruch pochodzący z usługi Event Grid i zoptymalizować pozyskiwanie zdarzeń do usługi Azure Data Explorer, zalecamy filtrowanie klucza data.api w celu wykluczenia zdarzeń CreateFile. Dzięki temu zdarzenia tworzenia plików o rozmiarze 0 są filtrowane, zapobiegając błędom pozyskiwania pustego pliku. Aby uzyskać więcej informacji na temat opróżniania, zobacz Azure Data Lake flush method (Metoda opróżniania usługi Azure Data Lake).

Zmienianie nazwy obiektów blob

W usłudze ADLSv2 można zmienić nazwy katalogów. Należy jednak pamiętać, że zmiana nazwy katalogu nie powoduje wyzwolenia zdarzeń o zmienionej nazwie obiektu blob ani zainicjowania pozyskiwania obiektów blob zawartych w katalogu. Jeśli chcesz zapewnić pozyskiwanie obiektów blob po zmianie nazwy katalogu, należy bezpośrednio zmienić nazwy poszczególnych obiektów blob w katalogu.

Poniższy przykładowy kod pokazuje, jak zmienić nazwę obiektu blob na koncie magazynu ADLSv2.

var accountName = <storage_account_name>;
var accountKey = <storage_account_key>;
var fileSystemName = <file_system_name>;
var sourceFilePath = <source_file_path>;
var destinationFilePath = <destination_file_path>;
var sharedKeyCredential = new StorageSharedKeyCredential(accountName, accountKey);
var dfsUri = "https://" + accountName + ".dfs.core.windows.net";
var dataLakeServiceClient = new DataLakeServiceClient(new Uri(dfsUri), sharedKeyCredential);
// Get a client to the the filesystem

var dataLakeFileSystemClient = dataLakeServiceClient.GetFileSystemClient(fileSystemName);
// Rename a file in the file system
var dataLakeFileClient = dataLakeFileSystemClient.GetFileClient(sourceFilePath);
dataLakeFileClient.Rename(destinationFilePath);

Uwaga

Jeśli zdefiniowano filtry do śledzenia określonych podmiotów podczas tworzenia połączenia danych lub podczas ręcznego tworzenia zasobów usługi Event Grid, te filtry są stosowane na ścieżce pliku docelowego.

Uwaga

Wyzwalanie pozyskiwania po CopyBlob operacji nie jest obsługiwane w przypadku kont magazynu z włączoną funkcją hierarchicznej przestrzeni nazw.

Usuwanie połączenia danych usługi Event Grid

Aby usunąć połączenie usługi Event Grid z Azure Portal, wykonaj następujące czynności:

Przejdź do klastra. W menu po lewej stronie wybierz pozycję Bazy danych. Następnie wybierz bazę danych zawierającą tabelę docelową.
W menu po lewej stronie wybierz pozycję Połączenia danych. Następnie zaznacz pole wyboru obok odpowiedniego połączenia danych usługi Event Grid.
Na górnym pasku menu wybierz pozycję Usuń.

Przetwarzanie danych z centrum zdarzeń przy użyciu usługi Azure Stream Analytics

Tworzenie połączenia danych usługi Event Grid dla usługi Azure Data Explorer

Wymagania wstępne

Tworzenie połączenia danych usługi Event Grid

Wybieranie miejsca docelowego do kierowania zdarzeń do

Tworzenie połączenia danych

Korzystanie z połączenia danych usługi Event Grid

Zmienianie nazwy obiektów blob

Usuwanie połączenia danych usługi Event Grid

Opinia

Opinia

Dodatkowe zasoby

Tworzenie połączenia danych usługi Event Grid dla usługi Azure Data Explorer

Wymagania wstępne

Tworzenie połączenia danych usługi Event Grid

Korzystanie z połączenia danych usługi Event Grid

Usuwanie połączenia danych usługi Event Grid

Zawartość pokrewna

Opinia

Opinia

Dodatkowe zasoby