> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Microsoft Fabric

> Kullanıcı davranışına dayalı otomatik Journey'leri ve kişiselleştirilmiş mesajlaşma kampanyalarını tetiklemek için özel olayları Microsoft Fabric'ten OneSignal'e senkronize edin.

export const PLATFORM_0 = "Microsoft Fabric"

export const DATA_TYPE_0 = "tablo sütunları"

export const COLUMN_HEADER_0 = "Fabric Sütunu"

export const PROPERTIES_DESCRIPTION_0 = "Olay meta verileri içeren JSON nesnesi"

## Genel bakış

OneSignal + Microsoft Fabric entegrasyonu, kullanıcı davranışına dayalı otomatik mesajlaşma kampanyalarını ve Journey'leri tetiklemek için Fabric lakehouse veya warehouse'unuzdan OneSignal'e özel olayların otomatik senkronizasyonunu sağlar.

Microsoft Fabric, veri mühendisliği, veri bilimi, gerçek zamanlı analitik ve iş zekasını tek bir ortamda bir araya getiren birleşik bir analitik platformudur.

***

## Gereksinimler

* Access to [Event Streams](/docs/en/event-streams) for outbound message events (Plan limitations and overages apply)
* Access to [Custom Events](/docs/en/custom-events) for inbound event syncing (Plan limitations and overages apply)
* [Updated Account Plan](https://onesignal.com/pricing) (not available on free apps)

### Microsoft Fabric

* Çalışma alanı erişimi olan **Microsoft Fabric kapasitesi**
* Uygun izinlere sahip **Service Principal**
* Olay verileri içeren **SQL Endpoint** (Warehouse veya Lakehouse)
* Kiracı ayarlarında etkinleştirilmiş **Harici API erişimi**

***

## Kurulum

<Steps>
  <Step title="Azure'da service principal oluşturun">
    OneSignal'in Fabric kaynaklarınıza erişmesi için yeni bir service principal oluşturun:

    1. Azure portalında oturum açın
    2. **Microsoft Entra ID** > **App registrations**'a gidin
    3. **+ New registration**'a tıklayın
    4. Adı girin: "OneSignal Fabric Integration"
    5. **Accounts in this organizational directory only**'yi seçin
    6. **Register**'a tıklayın
    7. **Application (client) ID** ve **Directory (tenant) ID**'yi not edin
    8. **Certificates & secrets** altında yeni bir client secret oluşturun
    9. **Client secret value**'yu not edin
  </Step>

  <Step title="Fabric kiracı ayarlarını yapılandırın">
    Service principal'lar için harici erişimi etkinleştirin:

    1. Microsoft Fabric'te **Settings** > **Admin portal**'a tıklayın
    2. **Tenant settings**'e gidin
    3. **Developer settings** altında **Service principals can use Fabric APIs**'yi etkinleştirin
    4. **OneLake settings** altında **Users can access data stored in OneLake with apps external to Fabric**'i etkinleştirin
  </Step>

  <Step title="Çalışma alanı erişimi verin">
    Service principal'ı Fabric çalışma alanınıza ekleyin:

    1. Çalışma alanınıza gidin ("My Workspace" kullanıyorsanız paylaşılan çalışma alanı oluşturun)
    2. **Manage Access** > **+ Add people or groups**'a tıklayın
    3. Service principal'ınızı seçin
    4. Rolü **Contributor** olarak ayarlayın
  </Step>

  <Step title="SQL endpoint'ini alın">
    Veri kaynağınız için SQL bağlantı dizesini edinin:

    1. Çalışma alanınızda warehouse/lakehouse'unuzun üzerine gelin
    2. **...** > **Settings**'e tıklayın
    3. **SQL connection string**'i kopyalayın (bu sizin hostname'inizdir)
  </Step>

  <Step title="OneSignal'e bağlanın">
    In OneSignal, go to **Data > Integrations** and click **Add Integration**.

    **Microsoft Fabric**'i seçin ve şunları sağlayın:

    * **Hostname:** Adım 4'ten SQL endpoint
    * **Database/Catalog:** Lakehouse veya warehouse adınız
    * **Tenant ID:** Adım 1'den Directory ID
    * **Client ID:** Adım 1'den Application ID
    * **Client Secret:** Adım 1'den Secret value
  </Step>
</Steps>

***

### Event data mapping

Map your {PLATFORM_0} {DATA_TYPE_0} to OneSignal's custom events format:

| OneSignal Field | {COLUMN_HEADER_0} | Description                | Required |
| --------------- | ----------------- | -------------------------- | -------- |
| `name`          | `event_name`      | Event identifier           | Yes      |
| `external_id`   | `user_id`         | User identifier            | Yes      |
| `timestamp`     | `event_timestamp` | When event occurred        | No       |
| `properties`    | `event_data`      | {PROPERTIES_DESCRIPTION_0} | No       |

### Örnek Olay Tablosu Şeması

```sql theme={null}
-- Örnek Fabric tablo yapısı
CREATE TABLE user_events (
    event_name STRING,
    user_id STRING,
    event_time TIMESTAMP,
    properties JSON,
    session_id STRING,
    device_type STRING
);
```

***

## İşleme Modları

### SQL Sorgu Modu

Senkronize etmeden önce Fabric verilerinizi dönüştürmek için özel SQL sorguları yazın:

```sql theme={null}
SELECT
    event_name,
    user_id,
    event_time,
    TO_JSON(STRUCT(
        session_id,
        device_type,
        product_id
    )) as properties
FROM user_events
WHERE event_time >= CURRENT_DATE - INTERVAL 7 DAYS
```

### Tablo Modu

Fabric çalışma alanınızdan doğrudan tüm tabloları veya görünümleri senkronize edin. OneSignal, sütunları olay alanlarına otomatik olarak eşleyecektir.

***

## Sınırlamalar

* Fabric kapasitesi gerektirir (denemede mevcut değildir)
* SQL endpoint'leri harici hizmetler tarafından erişilebilir olmalıdır
* Büyük sonuç kümeleri senkronizasyon performansını etkileyebilir

***

## SSS

### Sorgu performansını nasıl optimize ederim?

Fabric tablolarınızda bölümleme ve indeksleme kullanın. Sık erişilen olay verileri için materyalize edilmiş görünümler oluşturmayı düşünün.

### Hem lakehouse'lardan hem de warehouse'lardan senkronize edebilir miyim?

Evet, OneSignal lakehouse'lar, warehouse'lar ve SQL analitik endpoint'leri dahil olmak üzere SQL endpoint'i açığa çıkaran herhangi bir Fabric kaynağını destekler.

***